Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l’originale in inglese.

Add TalkBack Command

Aggiungi il comando TalkBack alla coda TalkBack

Richiesta

Metodo HTTP

POST

URL

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

Argomenti di input

Nome	Descrizione
<talkback_id>	(Obbligatorio) ID TalkBack, specificato come numero intero positivo.
<format>	Formato per la risposta HTTP, specificato come json o xml.

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

Parametri del corpo

Nome	Descrizione	Tipo di valore
api_key	(Obbligatorio) Chiave API per questa specifica istanza di TalkBack. La chiave TalkBack è diversa dalle chiavi API del canale dell'utente.	stringa
command_string	Comando da inviare al tuo dispositivo. Ciascuna stringa_comando è limitata a 255 caratteri.	stringa
position	(Facoltativo) La posizione in cui desideri che venga visualizzato il comando. Tutti i comandi precedenti in corrispondenza o dopo questa posizione vengono spostati verso il basso. Se la posizione viene lasciata vuota, il comando viene automaticamente aggiunto alla fine della coda con la posizione più alta.	numero intero

Tipo di contenuto

application/x-www-form-urlencoded

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

 Esempio di testo

Lascia vuoto <format> per ricevere la risposta in formato testo.

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

Risposta 2448500

 Esempio JSON

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

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

 Esempio XML

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

Risposta <?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>

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

Utilizza POSTMAN per aggiungere un comando TalkBack

Puoi utilizzare POSTMAN per provare le tue richieste HTTP utilizzando l'API RESTful per ThingSpeak. Questo esempio mostra come aggiungere un comando TalkBack a una coda esistente utilizzando POSTMAN.

Aggiungi il comando TalkBack LIGHTON a una coda TalkBack esistente con l'ID TalkBack 24507.

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

1. In POSTMAN, seleziona POST dall'elenco a discesa dei verbi HTTP e inserisci https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands nella barra degli indirizzi. Cambia TALKBACK_ID nel tuo ID TalkBack.

2. Inserisci il parametro api_key e la chiave API TalkBack, che si trova in Apps > TalkBack> YOUR TALKBACK NAME.

3. Inserisci i parametri e i valori aggiuntivi:

   • api_key, Value: XXXXXXXXXXXXXXXX

   • command_string, Value: LIGHTON

La risposta è in formato testo. Prendi nota del valore di risposta del server pari a 200 OK, che indica l'avvenuta aggiunta del comando alla coda TalkBack.

Il nuovo comando è ora disponibile nella coda TalkBack.

Vedi anche

Funzioni

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

Argomenti

• Comandi di coda utilizzando l'app TalkBack da MATLAB
• Monitora e agisci in caso di inattività del canale utilizzando le app ThingSpeak
• Controlla una luce con TalkBack su Arduino
• Aggiornamento dei canali e controllo della luce su Arduino
• Controlla una luce con TalkBack su ESP8266
• Aggiornamento del canale e controllo della luce con ESP8266
• Controlla una luce con TalkBack su ESP32
• Aggiornamento dei canali e controllo della luce con ESP32
• Proprietà del canale