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

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
<channel_id>	(Obbligatorio) ID canale per il canale di interesse.
<format>	(Facoltativo) Formato per la risposta HTTP, specificato come json, xml o csv.

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) 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
results	(Facoltativo) Numero di voci da recuperare, 8000 max.	numero intero
days	(Facoltativo) Numero di periodi di 24 ore prima di adesso da includere nella risposta. Il valore predefinito è 1.	numero intero
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

Suggerimento

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 da più di 1 giorno e limitare le voci, utilizzare insieme i parametri results e days .

Risposta

Successo

Codice di stato HTTP

200 OK

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

Corpo

 Esempio JSON

GET https://api.thingspeak.com/channels/1417/status.json?results=2 or GET https://api.thingspeak.com/channels/1417/status?results=2

Risposta The response is a JSON object of the channel statuses, for example:{ "channel": { "name": "CheerLights", "latitude": "40.5", "longitude": "-80.22" }, "feeds": [ { "created_at": "2014-02-26T02:28:01Z", "entry_id": 11888, "status": "@cheerlights green" }, { "created_at": "2014-02-26T22:05:31Z", "entry_id" :11889, "status": "@cheerlights blue" } ] }

 Esempio XML

GET https://api.thingspeak.com/channels/1417/status.xml?results=2

Risposta The response is a XML object of the channel statuses, for example: <?xml version="1.0" encoding="UTF-8"?> <channel> <name>CheerLights</name> <latitude type="decimal">40.5</latitude> <longitude type="decimal">-80.22</longitude> <feeds type="array"> <feed> <created-at type="dateTime">2014-02-26T02:28:01Z</created-at> <entry-id type="integer">11888</entry-id> <status>@cheerlights green</status> <id type="integer" nil="true"/> </feed> <feed> <created-at type="dateTime">2014-02-26T22:05:31Z</created-at> <entry-id type="integer">11889</entry-id> <status>@cheerlights blue</status> <id type="integer" nil="true"/> </feed> </feeds> </channel>

 Esempio CSV

GET https://api.thingspeak.com/channels/276330/status.csv?results=2

Risposta The response is a CSV object of the channel statuses, for example: created_at,entry_id,status 2017-10-16 15:15:12 UTC,3385,Soil is Wet. 2017-10-16 15:15:13 UTC,3386,Water needed soon!

Errore

Per l'elenco completo, vedere Codici di errore.

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

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 tre risultati di stato in formato JSON

Il canale 276330 memorizza le informazioni sull'umidità del suolo 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 . Aggiungi il primo parametro dopo un punto interrogativo ?. È possibile utilizzare il parametro dei risultati 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 dei risultati viene utilizzato per restituire un determinato numero 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 richiedi l'output nel formato csv , il file restituito è un formato variabile separato da virgole. A seconda della configurazione del computer, il browser può aprire software aggiuntivo per visualizzare questo formato. Per leggere i dati da un canale privato, fornire la chiave API di lettura dopo il parametro api_key. Aggiungi 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

Vedi anche

Funzioni

• Read Data | Read Field | Write Data | Bulk Write JSON Data | Bulk Write CSV Data

Argomenti

• Sensore di umidità che utilizza richieste HTTP POST al canale