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

Update TalkBack Command

Comando de actualización en la cola de TalkBack

Solicitud

Método HTTP

PUT

URL

https://api.thingspeak.com/talkbacks/<talkback_id>/commands/<command_id>.<format>

Argumentos de entrada

Nombre	Descripción
<talkback_id>	(Obligatorio) Id. de TalkBack, especificado como un número entero positivo.
<command_id>	(Obligatorio) Id. de comando para el comando de interés, especificado como un número entero positivo.
<format>	Formato para la respuesta HTTP, especificado como json o xml.

Ejemplo: https://api.thingspeak.com/talkbacks/12345/commands/23456.json

Parámetros del cuerpo

Nombre	Descripción	Tipo de valor
api_key	(Obligatorio) Clave de API para esta instancia específica de TalkBack. La clave de TalkBack es diferente de las claves de API del canal y del usuario.	cadena
command_string	Comando para ser enviado a su dispositivo. Cada command_string está limitado a 255 caracteres.	cadena

Tipo de contenido

application/x-www-form-urlencoded

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

Las respuestas de ejemplo se basan en este cambio en una cola de TalkBack de muestra.

 Ejemplo de texto

Abandonar <format> en blanco para recibir la respuesta en formato de texto.

PUT https://api.thingspeak.com/talkbacks/12345/commands/23456 api_key=XXXXXXXXXXXXXXXX command_string=CLOSEDOOR position=2

Respuesta CLOSEDOOR

 Ejemplo JSON

PUT https://api.thingspeak.com/talkbacks/12345/commands/23456.json api_key=XXXXXXXXXXXXXXXX command_string=CLOSEDOOR

Respuesta { "command_string": "OPENDOOR", "created_at": "2019-12-29T17:53:40-05:00", "executed_at": null, "id": 23456, "position": 2 }

 Ejemplo XML

PUT https://api.thingspeak.com/talkbacks/12345/commands/15200362.xml api_key=XXXXXXXXXXXXXXXX command_string=CLOSEDOOR position=2

Respuesta <?xml version="1.0" encoding="UTF-8"?> <command> <id type="integer">15200362</id> <command-string>CLOSEDOOR</command-string> <position type="integer">3</position> <executed-at type="dateTime" nil="true"/> <created-at type="dateTime">2019-02-20T16:24:04Z</created-at> </command>

Error

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

Ejemplos

Use POSTMAN para actualizar un comando de TalkBack

Puedes usar POSTMAN para probar sus solicitudes HTTP utilizando la API RESTful para ThingSpeak. Este ejemplo muestra cómo agregar un comando TalkBack a una cola existente mediante POSTMAN.

Cambiar el comando TalkBack BUCKLESHOE a una cola de TalkBack existente con el ID de TalkBack 15200362.

PUT https://api.thingspeak.com/talkbacks/23341/commands/15200362.xml
    api_key=XXXXXXXXXXXXXXXX
    command_string=CLOSEDOOR
    

1. En POSTMAN, seleccione PUT de la lista desplegable de verbos HTTP e ingrese https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands/ en la barra de direcciones. Cambio TALKBACK_ID a tu ID de TalkBack.

2. Introduzca el parámetro api_key y su clave API de TalkBack, que se encuentra en Apps > TalkBack> YOUR TALKBACK NAME.

3. Introduzca los parámetros y valores adicionales:

   • api_key, Value: XXXXXXXXXXXXXXXX

   • command_string, Value: CLOSEDOOR

La respuesta está en formato XML. Tenga en cuenta el valor de respuesta del servidor de 200 OK, lo que indica una actualización exitosa de su comando TalkBack.

El comando actualizado ya está disponible en la cola de TalkBack.

Consulte también

Funciones

• Add Command | Get Command | Get Last Command | Execute Command | Delete Command

Temas

• Comandos en cola con la aplicación TalkBack desde MATLAB
• Monitorear y actuar sobre la inactividad del canal usando ThingSpeak aplicaciones
• Controla una luz con TalkBack en Arduino
• Actualización de canales y control de luces en Arduino
• Controla una luz con TalkBack en ESP8266
• Actualización de canales y control de luces con ESP8266
• Controla una luz con TalkBack en ESP32
• Actualización de canales y control de luces con ESP32