Main Content

Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la versión original en inglés.

Write Image

Escribir imagen de canal con HTTP POST

Pedido

Método HTTP

POST

URL

https://data.thingspeak.com/channels/<channel_id>/images/<filename>/<timestamp>

Parámetros de URL

NombreDescripción

<channel_id>

(Obligatorio) ID del canal en el que se escribirá el canal de imagen.

<filename>(Opcional) Nombre del archivo de imagen.
<timestamp>(Opcional) Marca de tiempo proporcionada por el cliente.

Ejemplo:https://data.thingspeak.com/channels/123456/images/MVseg_01.jpg/2022-01-29T15:06:35.642Z

Cuerpo

El cuerpo del POST son los datos de la imagen. Los medios para especificar el archivo dependen de la utilidad.

Encabezados

Los siguientes encabezados son necesarios para una solicitud POST de imagen.

Nombre claveValor
Content-type

(Obligatorio) image/jpeg

thingspeak-image-channel-api-key

(Obligatorio) La clave API para este canal de imágenes específico. La clave API de escritura se encuentra en la columna API Keys de la tabla de canales de imagen.

Respuesta

Éxito

Código de estado HTTP

202 OK

Respuesta JSON

La respuesta es un objeto JSON de la nueva entrada, por ejemplo:

{
    "requestID": "cmnog8kdd00224cmc4cz0dnwo",
    "code": 0,
    "status": "PENDING",
    "message": null
}

Errores

Para obtener la lista completa, consulte Códigos de error.

Limitaciones

  • Debes tener una licencia paga para crear un canal de imágenes.

  • El único formato de imagen admitido es JPEG/JPG.

  • Las imágenes tienen un tamaño limitado a 5 MB. Los que son un poco más grandes se reducen automáticamente. Se rechazan las imágenes significativamente más grandes.

  • Todas las marcas de tiempo deben ser únicas dentro de un canal. No puede escribir una nueva imagen utilizando una marca de tiempo que coincida con la marca de tiempo de una imagen existente en el canal.

Ejemplos

expandir todo

El siguiente código opera en un shell Linux® . Cambie el ID del canal, la clave API y el nombre del archivo según corresponda.

curl --location --request POST "https://data.thingspeak.com/channels/95b0766f76/images" \
--header "Content-Type: image/jpeg" \
--header "thingspeak-image-channel-api-key: M3I17NS05QKZ6Q5D" \
--data-binary "./MyImage44.jpg"

La cruda respuesta es:

{"requestID":"cl2t7ybd40ppo07k7fo2lbi83","code":0,"status":"PENDING"}

Puede utilizar Postman para probar sus solicitudes HTTP utilizando la API RESTful para ThingSpeak. Este ejemplo muestra cómo escribir datos en un canal usando Postman.

  1. En Postman, seleccione POST de la lista desplegable de verbos HTTP.

  2. Ingresa https://data.thingspeak.com/channels/<channel_id>/images en el campo de dirección, reemplazando <channel_id> con el ID del canal en el que estás escribiendo la imagen.

  3. En la pestaña Headers , ingrese las siguientes claves de parámetros:

    • Content-type con el valor image/jpeg.

    • thingspeak-image-channel-api-key con el valor de la clave API de tu canal de imágenes, que está disponible en ThingSpeak™ Channels > My Image Channels listado.

    Postman image post headers

  4. En la pestaña Body, seleccione binary, luego haga clic en Select File para buscar el archivo de imagen con el explorador de archivos.

    Postman image post body

  5. Haga clic en Send para PUBLICAR su imagen. La respuesta es un objeto JSON con ID de solicitud, código y estado; y un 202 Accepted del servidor.

    Postman image post response