Read Status
Leggi il campo di stato del canale con HTTP GET
Richiesta
Metodo HTTP
GET
URL
https://api.thingspeak.com/channels/<channel_id>/status.<format>
Parametri URL
| Nome | Descrizione |
|---|---|
| (Obbligatorio) ID del canale di interesse. |
| (Facoltativo) Formato per la risposta HTTP, specificato come |
Esempio: https://api.thingspeak.com/channels/266256/status.json
Parametri della stringa di query
| Nome | Descrizione | Tipo 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 |
results | (Facoltativo) Numero di voci da recuperare, massimo 8000. | intero |
days | (Facoltativo) Numero di periodi di 24 ore precedenti ad ora da includere nella risposta. Il valore predefinito è 1. | intero |
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 |
Mancia
Il parametro results determina il numero massimo di voci da recuperare per una query, fino a 8000. L'intervallo di tempo predefinito è limitato a 1 giorno (24 ore). Per ottenere risultati per più di 1 giorno e limitare le voci, utilizzare insieme i parametri results e days.
Risposta
Successo
200 OK
Se non si ha accesso al canale, la risposta è -1.
Errore
Per l'elenco completo, vedere Codici di errore.
Se non si ha accesso al canale, la risposta è -1.
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 tre risultati di stato in formato JSON
Il canale 276330 memorizza le informazioni sull'umidità del terreno per una pianta da ufficio. 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 di stato dal canale 276330 nel formato JSON. Aggiungere il primo parametro dopo un punto interrogativo ?. È possibile utilizzare il parametro results per controllare il numero di voci restituite, fino a 8000.
https://api.thingspeak.com/channels/276330/status.json?results=3
Leggi quattro risultati di stato in formato XML
In questo esempio, il formato è specificato come XML. Il parametro results viene utilizzato per restituire un numero definito di voci, in questo caso quattro. Il primo parametro viene aggiunto dopo un punto interrogativo ?.
https://api.thingspeak.com/channels/276330/status.xml?results=4
Leggi cinque risultati di 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ò aprire software aggiuntivi per visualizzare questo formato. Per leggere i dati da un canale privato, fornire la chiave API di lettura dopo il parametro api_key. Aggiungere il primo parametro dopo un punto interrogativo ?. Utilizzare una e commerciale & per aggiungere il secondo parametro. In questo caso, il parametro results viene utilizzato per restituire cinque risultati.
https://api.thingspeak.com/channels/276330/status.csv?api_key=E52AWRAV1RSXQQJW&results=5
