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

espandi tutto nella pagina

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 e dell'utente.	stringa
`command_string`	Comando da inviare al tuo dispositivo. Ogni command_string è limitata a 255 caratteri.	stringa
`position`	(Facoltativo) La posizione in cui si desidera che venga visualizzato il comando. Tutti i comandi precedenti in questa posizione o dopo questa 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.	intero

Tipo di contenuto

application/x-www-form-urlencoded

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

Esempio di testo

Esempio JSON

Esempio XML

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

espandi tutto

Utilizzare POSTMAN per aggiungere 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.

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

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

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. Sostituisci TALKBACK_ID con il tuo ID TalkBack.
Inserisci il parametro api_key e la tua chiave API TalkBack, che si trova in Apps > TalkBack> YOUR TALKBACK NAME.
Inserisci i parametri e i valori aggiuntivi:
- api_key, Value: XXXXXXXXXXXXXXXX
- command_string, Value: LIGHTON

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