Contenuto principale

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 del 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) Specificare la chiave API di lettura per questo canale specifico. La chiave API di lettura si trova nella scheda API Keys della vista canale.

stringa

timezone

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

stringa

offset

(Facoltativo) Offset del fuso orario in cui vengono visualizzati i risultati. Per una maggiore precisione, utilizzare il parametro fuso orario.

intero

status

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

true o false

location

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

true o false

prepend

(Facoltativo) Testo da aggiungere prima della risposta API.

stringa
append

(Facoltativo) Testo da aggiungere dopo la risposta API.

stringa

Esempi

Puoi utilizzare il tuo browser web per completare le richieste HTTP GET all'API RESTful per ThingSpeak™. Per visualizzare il formato di una risposta HTTP, fare clic sul collegamento o copiarlo 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 si include il parametro offset, ThingSpeak restituisce i dati temporali con lo scostamento specificato da GMT. Aggiungere 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 si richiede l'output nel formato csv, il file restituito è un formato di variabile separata da virgole. A seconda della configurazione del computer, il browser può avviare software aggiuntivi per visualizzare questo formato. Per leggere da un canale privato è necessaria 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 di stato del canale per l'ultimo campo insieme ai dati del feed. Aggiungere 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 si ha accesso al canale, la risposta è -1.