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.

Add TalkBack Command

Agregue el comando TalkBack a la cola de TalkBack

Solicitud

Método HTTP

POST

URL

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

Argumentos de entrada

NombreDescripción

<talkback_id>

(Obligatorio) Id. de TalkBack, 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

Parámetros del cuerpo

NombreDescripciónTipo 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

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

 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 agregar un comando TalkBack a una cola existente mediante POSTMAN.

Agregar 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. 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: LIGHTON

La respuesta está en formato de texto. Tenga en cuenta el valor de respuesta del servidor de 200 OK, lo que indica que se agregó correctamente el comando a su cola de TalkBack.

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