Main Content

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

Read Last Field Entry

Leggi l'ultima voce nel campo del canale con HTTP GET

Richiesta

Metodo HTTP

GET

URL

https://api.thingspeak.com/channels/<channel_id>/fields/<field_id>/last.<format>

Parametri URL

NomeDescrizione

<channel_id>

(Obbligatorio) ID canale per il canale di interesse.

<field_id>

(Obbligatorio) ID campo per il campo di interesse.

<format>

(Obbligatorio) Formato per la risposta HTTP, specificato come json, xml, csv o txt.

Esempio: https://api.thingspeak.com/channels/266256/fields/2/last.json

Parametri della stringa di query

NomeDescrizioneTipo di valore
api_key

(Obbligatorio per i canali privati) Specifica la chiave API di lettura per questo canale specifico. La chiave API di lettura si trova nella scheda API Keys della visualizzazione canale.

stringa

timezone

(Facoltativo) Identificatore da Riferimento ai fusi orari per questa richiesta.

stringa

offset

(Facoltativo) Differenza del fuso orario in cui vengono visualizzati i risultati. Utilizza il parametro fuso orario per una maggiore precisione.

numero intero

status

(Facoltativo) Includi gli aggiornamenti di stato nel feed impostando "status=true".

true oppure false

location

(Facoltativo) Includi latitudine, longitudine e altitudine nel feed impostando "location=true".

true oppure false

prepend

(Facoltativo) Testo da aggiungere prima della risposta API.

stringa
append

(Facoltativo) Testo da aggiungere dopo la risposta API.

stringa

Esempi

È possibile utilizzare il browser Web per completare le richieste GET HTTP all'API RESTful per ThingSpeak™. Per visualizzare il formato di una risposta HTTP, fai clic sul collegamento o copialo nel browser.

Leggi l'ultima voce in formato JSON

Il canale 9 contiene informazioni provenienti da diversi sensori dell'ambiente domestico. Puoi leggere i dati da questo canale pubblico. Il formato della risposta si trova alla fine dell'URL, prima di qualsiasi parametro della stringa di query. Questo esempio restituisce l'ultima voce dal canale 9 nel formato JSON .

https://api.thingspeak.com/channels/9/fields/2/last.json

Leggi l'ultima voce inclusa la posizione in formato XML

Quando includi il parametro offset , ThingSpeak restituisce i dati orari con l'offset specificato da GMT. Aggiungi il primo parametro dopo un punto interrogativo ?. Questa richiesta restituisce i risultati nel formato XML .

https://api.thingspeak.com/channels/9/fields/2/last.xml?offset=3

Leggi l'ultima voce incluso lo stato da un canale privato in formato CSV

Quando richiedi l'output nel formato csv , il file restituito è un formato variabile separato da virgole. A seconda della configurazione del computer, il browser può avviare software aggiuntivo per visualizzare questo formato. La lettura da un canale privato richiede la chiave API di lettura. Utilizzare il parametro della stringa di query api_key per specificare la chiave API. Ogni voce ha anche un campo di stato. In questo esempio, status=true restituisce la voce sullo stato del canale per l'ultimo campo insieme ai dati del feed. Aggiungi il secondo parametro dopo la e commerciale &.

https://api.thingspeak.com/channels/9/fields/2/last.csv?api_key=E52AWRAV1RSXQQJW&status=true

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

 Esempio di testo

 Esempio JSON

 Esempio XML

 Esempio CSV

Errore

Per l'elenco completo, vedere Codici di errore.

Se non hai accesso al canale, la risposta è -1.