Main Content

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 canale per il 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) 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

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 e fornisci 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 risultati in formato XML

Quando includi location=true, ThingSpeak restituisce le informazioni sulla posizione per l'ultima voce. Le informazioni sulla posizione di ingresso sono diverse dalle informazioni sulla posizione del canale, che sono impostate nella scheda Channel Settings . Aggiungi 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 risultati 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 dello 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/feeds/last.csv?api_key=E52AWRAV1RSXQQJW&status=true

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

 JSON o esempio di testo

 Esempio XML

 Esempio CSV

Errore

Per l'elenco completo, vedere Codici di errore.

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