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

Write Data and Execute TalkBack Command

Aggiorna i dati del canale con HTTP GET o POST ed esegui il comando TalkBack

Richiesta

Metodo HTTP

POST o GET

URL

https://api.thingspeak.com/update.<format>

Parametri URL

Nome	Descrizione
<format>	Formato per la risposta HTTP, specificato come json o xml.

Esempio: https://api.thingspeak.com/update.json?api_key=XXXXXXXXXXXXXXXXtalkback_key=YYYYYYYYYYYYYYYY

Corpo

Nome	Descrizione	Tipo di valore
api_key	(Obbligatorio) Specificare la chiave API di scrittura per questo canale specifico. È anche possibile inviare la chiave API di scrittura utilizzando un'intestazione HTTP THINGSPEAKAPIKEY. La chiave API di scrittura si trova nella scheda API Keys della vista canale.	stringa
talkback_key	(Obbligatorio) Chiave API per un'istanza specifica di TalkBack. L'inclusione della chiave API TalkBack determina la rimozione del comando successivo nella coda e la restituzione del comando nella risposta.	stringa
field<X>	(Facoltativo) Dati del campo X, dove X è l'ID del campo	Qualunque
lat	(Facoltativo) Latitudine in gradi	decimale
long	(Facoltativo) Longitudine in gradi	decimale
elevation	(Facoltativo) Altitudine in metri	intero
status	(Facoltativo) Messaggio di aggiornamento dello stato	stringa
created_at	(Facoltativo) Data di creazione della voce del feed, nel formato ISO 8601, ad esempio 2014-12-31 23:59:59. Deve essere univoco all'interno del canale. I fusi orari possono essere specificati utilizzando il parametro timezone.	datetime

Tipo di contenuto

Content-Type è richiesto solo per il metodo POST, non per il metodo GET.

Utilizzare application/json per gli aggiornamenti in formato JSON.

Utilizzare application/x-www-form-urlencoded per tutti gli altri aggiornamenti.

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

 Esempio di testo

POST https://api.thingspeak.com/update api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

Risposta La risposta è la stringa di comando del successivo comando TalkBack nella coda TalkBack con la chiave API TalkBack specificata. Se l'aggiornamento fallisce, la risposta è 0.

 Esempio JSON

POST https://api.thingspeak.com/update.json api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

La risposta è un oggetto JSON del comando successivo nella coda di TalkBack con la chiave API di TalkBack specificata, ad esempio: { "id": 15254213, "command_string": "OPENDOOR", "position": null, "executed_at": "2019-03-05T15:48:29Z", "created_at": "2019-02-26T13:45:09Z" }

 Esempio XML

POST https://api.thingspeak.com/update.xml api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

La risposta è un oggetto XML del comando successivo nella coda di TalkBack con la chiave API di TalkBack specificata, ad esempio: <command> <id type="integer">15338752</id> <command-string>OPENDOOR</command-string> <position type="integer" nil="true"/> <executed-at type="dateTime">2019-03-05T15:52:08Z</executed-at> <created-at type="dateTime">2019-03-05T15:51:54Z</created-at> </command>

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

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 aggiornare contemporaneamente un canale ed eseguire un comando TalkBack da una coda esistente utilizzando POSTMAN.

Scrivi 123 nel campo 1 di un canale e restituisci il successivo comando TalkBack in una coda TalkBack esistente.

POST https://api.thingspeak.com/update
     api_key=XXXXXXXXXXXXXXXX
     talkback_key=YYYYYYYYYYYYYYYYY

1. In POSTMAN, seleziona POST dall'elenco a discesa dei verbi HTTP e inserisci https://api.thingspeak.com/update nella barra degli indirizzi.

2. Inserisci i parametri e i valori aggiuntivi:

   • Key: api_key, Value: XXXXXXXXXXXXXXXX

   • Key: talkback_key, Value: YYYYYYYYYYYYYYYY

La risposta è in formato testo. Si noti il valore di risposta del server pari a 200 OK, che indica l'aggiornamento del canale e l'esecuzione del comando TalkBack riusciti.

Il comando eseguito viene mostrato nella risposta.

Limitazioni

Tutti i timestamp devono essere univoci. Non è possibile scrivere nuovi dati utilizzando timestamp che corrispondono ai dati esistenti nel canale.

Vedi anche

Bulk Write Data | Add Command | Get All Commands | Update Command | Execute Command | Delete Command