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 Data and Execute TalkBack Command

Actualice los datos del canal con HTTP GET o POST y ejecute el comando TalkBack

Solicitud

Método HTTP

POST o GET

URL

https://api.thingspeak.com/update.<format>

Parámetros de URL

NombreDescripción

<format>

Formato para la respuesta HTTP, especificado como json o xml.

Ejemplo: https://api.thingspeak.com/update.json?api_key=XXXXXXXXXXXXXXXXtalkback_key=YYYYYYYYYYYYYYYY

Cuerpo

NombreDescripciónTipo de valor
api_key

(Obligatorio) Especifique la clave API de escritura para este canal específico. También puede enviar la clave API de escritura mediante un encabezado HTTP THINGSPEAKAPIKEY. La clave API de escritura se encuentra en el API Keys pestaña de la vista del canal.

cadena

talkback_key

(Obligatorio) Clave de API para una instancia específica de TalkBack. La inclusión de la clave API de TalkBack hace que se elimine el siguiente comando de la cola y devuelve el comando en la respuesta.

cadena
field<X>

(Opcional) Datos del campo X, donde X es el ID del campo

ningún
lat

(Opcional) Latitud en grados

decimal

long

(Opcional) Longitud en grados

decimal
elevation

(Opcional) Elevación en metros

entero
status

(Opcional) Mensaje de actualización de estado

cadena
twitter(Opcional) Twitter® nombre de usuario vinculado a ThingTweetcadena
tweet(Opcional) Twitter actualización de estadocadena
created_at

(Opcional) Fecha en que se creó la entrada del feed, en ISO 8601 formato, por ejemplo, 2014-12-31 23:59:59. Debe ser único dentro del canal. Las zonas horarias se pueden especificar mediante el parámetro de zona horaria.

fecha y hora

Tipo de contenido

Content-Type solo se requiere para el método POST, no para el método GET.

Usar application/json para actualizaciones en formato JSON.

Usar application/x-www-form-urlencoded para todas las demás actualizaciones.

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

 Ejemplo de texto

 Ejemplo JSON

 Ejemplo XML

Error

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

Ejemplos

expandir todo

Puedes usar POSTMAN para probar sus solicitudes HTTP utilizando la API RESTful para ThingSpeak. Este ejemplo muestra cómo actualizar simultáneamente un canal y ejecutar un comando TalkBack desde una cola existente usando POSTMAN.

Escribe 123 al campo 1 de un canal y devolver el siguiente comando de TalkBack en una cola de TalkBack existente.

POST https://api.thingspeak.com/update
     api_key=XXXXXXXXXXXXXXXX
     talkback_key=YYYYYYYYYYYYYYYYY

  1. En POSTMAN, seleccione POST de la lista desplegable de verbos HTTP e ingrese https://api.thingspeak.com/update en la barra de direcciones.

  2. Introduzca los parámetros y valores adicionales:

    • Key: api_key, Value: XXXXXXXXXXXXXXXX

    • Key: talkback_key, Value: YYYYYYYYYYYYYYYY

La respuesta está en formato de texto. Tenga en cuenta el valor de respuesta del servidor de 200 OK, lo que indica que la actualización del canal y la ejecución del comando TalkBack se realizaron correctamente.

El comando ejecutado se muestra en la respuesta.

Limitaciones

Todas las marcas de tiempo deben ser únicas. No puede escribir nuevos datos utilizando marcas de tiempo que coincidan con los datos existentes en el canal.