Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

Update TalkBack Command

Aggiorna il comando nella coda TalkBack

espandi tutto nella pagina

Richiesta

Metodo HTTP

PUT

URL

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

Argomenti di input

NomeDescrizione

<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

NomeDescrizioneTipo 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.

string

command_string

Comando da inviare al tuo dispositivo. Ciascuna stringa_comando è limitata a 255 caratteri.

string

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

 Esempio JSON

 Esempio XML

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

espandi tutto

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.

Modifica il comando TalkBack BUCKLESHOE in una coda TalkBack esistente con l'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. 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: CLOSEDOOR

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

Il comando aggiornato è ora disponibile nella coda TalkBack.

Vedi anche

Funzioni

Argomenti