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

Pedido

Método HTTP

POST o GET

URL

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

Parámetros de URL

Nombre	Descripción
<format>	Formato de la respuesta HTTP, especificado como json o xml.

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

Cuerpo

Nombre	Descripción	Tipo de valor
api_key	(Obligatorio) Especifique Escribir clave API para este canal específico. También puede enviar la clave API de escritura mediante un encabezado HTTP THINGSPEAKAPIKEY. La clave de API de escritura se encuentra en la pestaña API Keys de la vista del canal.	cadena
talkback_key	(Obligatorio) Clave 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	cualquier
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 ThingTweet	cadena
tweet	(Opcional) Twitter actualización de estado	cadena
created_at	(Opcional) Fecha en la que se creó la entrada del feed, en formato ISO 8601 , por ejemplo, 2014-12-31 23:59:59. Debe ser único dentro del canal. Las zonas horarias se pueden especificar utilizando el parámetro de zona horaria.	fecha y hora

Tipo de contenido

El tipo de contenido solo es necesario para el método POST, no para el método GET.

Utilice application/json para actualizaciones en formato JSON.

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

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

 Ejemplo de texto

POST https://api.thingspeak.com/update api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

Respuesta La respuesta es la cadena de comando del siguiente comando de TalkBack en la cola de TalkBack con la clave API de TalkBack especificada. Si la actualización falla, la respuesta es 0.

 Ejemplo JSON

POST https://api.thingspeak.com/update.json api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

La respuesta es un objeto JSON del siguiente comando en la cola de TalkBack con la clave API de TalkBack especificada, por ejemplo: { "id": 15254213, "command_string": "OPENDOOR", "position": null, "executed_at": "2019-03-05T15:48:29Z", "created_at": "2019-02-26T13:45:09Z" }

 Ejemplo XML

POST https://api.thingspeak.com/update.xml api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

La respuesta es un objeto XML del siguiente comando en la cola de TalkBack con la clave API de TalkBack especificada, por ejemplo: <command> <id type="integer">15338752</id> <command-string>OPENDOOR</command-string> <position type="integer" nil="true"/> <executed-at type="dateTime">2019-03-05T15:52:08Z</executed-at> <created-at type="dateTime">2019-03-05T15:51:54Z</created-at> </command>

Error

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

Ejemplos

Utilice POSTMAN para agregar un comando TalkBack

Puede utilizar 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.

Escriba 123 en el campo 1 de un canal y devuelva 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, que indica una actualización exitosa del canal y la ejecución del comando TalkBack.

El comando ejecutado se muestra en la respuesta.

Limitaciones

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

Consulte también

Bulk Write Data | Add Command | Get All Commands | Update Command | Execute Command | Delete Command