Contenuto principale

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

Read Last Entry

Leggi l'ultima voce nel canale con HTTP GET

Richiesta

Metodo HTTP

GET

URL

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

Parametri URL

NomeDescrizione

<channel_id>

(Obbligatorio) ID del canale di interesse.

<format>

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

Esempio: https://api.thingspeak.com/channels/266256/feeds/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

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 e fornisci i risultati 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/feeds/last.json

Leggi l'ultima voce, inclusa la posizione, e fornisci i risultati in formato XML

Se si include location=true, ThingSpeak restituisce le informazioni sulla posizione dell'ultima voce. Le informazioni sulla posizione di ingresso sono diverse dalle informazioni sulla posizione del canale, impostate nella scheda Channel Settings. Aggiungere il primo parametro dopo un punto interrogativo ?. Questa richiesta restituisce i risultati nel formato XML.

https://api.thingspeak.com/channels/9/feeds/last.xml?location=true

Leggi l'ultima voce, incluso lo stato, da un canale privato e fornisci i risultati 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/feeds/last.csv?api_key=E52AWRAV1RSXQQJW&status=true

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

 Esempio JSON o testo

 Esempio XML

 Esempio CSV

Errore

Per l'elenco completo, vedere Codici di errore.

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