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

Add TalkBack Command

Agregar el comando TalkBack a la cola de TalkBack

Pedido

Método HTTP

POST

URL

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

Argumentos de entrada

Nombre	Descripción
<talkback_id>	(Obligatorio) ID de TalkBack, especificado como un número entero positivo.
<format>	Formato de la respuesta HTTP, especificado como json o xml.

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

Parámetros del cuerpo

Nombre	Descripción	Tipo de valor
api_key	(Obligatoria) Clave API para esta instancia específica de TalkBack. La clave TalkBack es diferente de las claves API de canal y usuario.	cadena
command_string	Comando que se enviará a su dispositivo. Cada cadena_comando está limitada a 255 caracteres.	cadena
position	(Opcional) La posición en la que desea que aparezca el comando. Cualquier comando anterior en o después de esta posición se desplaza hacia abajo. Si la posición se deja en blanco, el comando se agrega automáticamente al final de la cola con la posición más alta.	entero

Tipo de contenido

application/x-www-form-urlencoded

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

 Ejemplo de texto

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

POST https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands api_key=YOUR_TALKBACK_API_KEY command_string=OPENDOOR position=5

Respuesta 2448500

 Ejemplo JSON

POST https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands.json api_key=YOUR_TALKBACK_API_KEY command_string=OPENDOOR

Respuesta { "id": 2448500, "command_string": "OPENDOOR", "position": 5, "executed_at": null, "created_at": "2016-08-29T15:12:36Z" }

 Ejemplo XML

POST https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands.xml api_key=YOUR_TALKBACK_API_KEY command_string=OPENDOOR&position=5

Respuesta <?xml version="1.0" encoding="UTF-8"?> <command> <id type="integer">2448500</id> <command-string>OPENDOOR</command-string> <position type="integer">5</position> <executed-at type="datetime" nil="true"/> <created-at type="datetime">2013-12-30T16:51:17-05:00</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 agregar un comando TalkBack a una cola existente usando POSTMAN.

Agregue el comando TalkBack LIGHTON a una cola de TalkBack existente con el ID de TalkBack 24507.

POST https://api.thingspeak.com/talkbacks/24507/commands
     api_key=YOUR_TALKBACK_API_KEY
     command_string=LIGHTON

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

2. Ingresa el parámetro api_key y tu 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: LIGHTON

La respuesta está en formato de texto. Tenga en cuenta el valor de respuesta del servidor de 200 OK, que indica la adición exitosa del comando a su cola de TalkBack.

El nuevo comando ahora está disponible en su cola de TalkBack.

Consulte también

Funciones

• Get Command | Update Command | Execute Command | Delete Command

Temas

• Comandos de cola usando la aplicación TalkBack desde MATLAB
• Controlar una luz con TalkBack en Arduino
• Supervise y actúe ante la inactividad del canal utilizando aplicaciones ThingSpeak
• Controlar una luz con TalkBack en Arduino
• Actualización de canales y control de luces en Arduino
• Controlar una luz con TalkBack en ESP8266
• Actualización de canales y control de luces con ESP8266
• Controlar una luz con TalkBack en ESP32
• Actualización de canales y control de luces con ESP32
• Propiedades del canal