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

Update TalkBack Command

Aggiorna il comando nella coda di TalkBack

Richiesta

Metodo HTTP

PUT

URL

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

Argomenti di input

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

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

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 e dell'utente.	stringa
command_string	Comando da inviare al tuo dispositivo. Ogni command_string è limitata a 255 caratteri.	stringa

Tipo di contenuto

application/x-www-form-urlencoded

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

Le risposte di esempio si basano su questa modifica in una coda TalkBack di esempio.

 Esempio di testo

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

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

Risposta CLOSEDOOR

 Esempio JSON

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

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

 Esempio XML

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

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

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

Utilizzare POSTMAN per aggiornare un comando TalkBack

Puoi usare 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.

Sostituisci il comando TalkBack BUCKLESHOE con una coda TalkBack esistente con ID TalkBack 15200362.

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

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

2. Inserisci il parametro api_key e la tua 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: CLOSEDOOR

La risposta è in formato XML. Notare il valore di risposta del server pari a 200 OK, che indica l'aggiornamento riuscito del comando TalkBack.

Il comando aggiornato è ora disponibile nella coda di TalkBack.

Vedi anche

Funzioni

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

Argomenti

• Comandi di coda tramite l'app TalkBack da MATLAB
• Monitora e agisci sull'inattività del canale utilizzando le app ThingSpeak
• Controllare una luce con TalkBack su Arduino
• Aggiornamento del canale e controllo della luce su Arduino
• Controllare una luce con TalkBack su ESP8266
• Aggiornamento del canale e controllo della luce con ESP8266
• Controlla una luce con TalkBack su ESP32
• Aggiornamento del canale e controllo della luce con ESP32