Read Data
Leggi i dati da tutti i campi nel canale con HTTP GET
Richiesta
Metodo HTTP
GET
URL
https://api.thingspeak.com/channels/
<channel_id>
/feeds.<format>
Parametri URL
Nome | Descrizione |
---|---|
| (Obbligatorio) ID canale per il canale di interesse. |
| (Obbligatorio) Formato per la risposta HTTP, specificato come |
Esempio: https://api.thingspeak.com/channels/266256/feeds.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. Il numero massimo è 8.000. | numero intero |
days | (Facoltativo) Numero di periodi di 24 ore prima di adesso da includere nella risposta. Il valore predefinito è 1. | numero intero |
minutes | (Facoltativo) Numero di periodi di 60 secondi prima di adesso da includere nella risposta. Il valore predefinito è 1440. | numero intero |
start | (Facoltativo) Data di inizio nel formato AAAA-MM-GG%20HH:NN:SS. | datetime |
end | (Facoltativo) Data di fine nel formato AAAA-MM-GG%20HH:NN:SS. | datetime |
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". |
|
metadata | (Facoltativo) Includi i metadati per un canale impostando "metadata=true". |
|
location | (Facoltativo) Includi latitudine, longitudine e altitudine nel feed impostando "location=true". |
|
min | (Facoltativo) Valore minimo da includere nella risposta. | decimale |
max | (Facoltativo) Valore massimo da includere nella risposta. | decimale |
round | (Facoltativo) Arrotondare a questo numero di cifre decimali. | numero intero |
timescale | (Facoltativo) Ottieni il primo valore in questo numero di minuti, valori validi: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero". | numero intero o stringa |
sum | (Facoltativo) Ottieni la somma di questi minuti, valori validi: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero". | numero intero o stringa |
average | (Facoltativo) Ottieni la media di questi minuti, valori validi: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero". Nota: i valori | numero intero o stringa |
median | (Facoltativo) Ottieni la mediana di questo numero di minuti, valori validi: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero". |
|
Suggerimento
Il parametro results
ha la massima precedenza. Utilizzando results
con i parametri min
, max
, timescale
, sum
, average
o median
possono causare la restituzione di meno di 8000 record. Il parametro results
determina il numero massimo di voci da utilizzare per una query, fino a 8000. Ad esempio, considera un canale con un aggiornamento al minuto. Una richiesta di lettura su quel canale con i parametri ?results=120&sum=60
restituisce solo due record e non 120. Vedi l'esempio Read Two Hours of Entries in JSON Format and Average.
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 voci 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. Aggiungi il primo parametro dopo un punto interrogativo ?
. È possibile utilizzare il parametro dei risultati per controllare il numero di voci restituite, che può arrivare fino a 8000.
Leggi due ore di voci in formato JSON e media
Il canale 9 contiene informazioni provenienti da diversi sensori dell'ambiente domestico, si aggiorna una volta al minuto. 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. Aggiungi il primo parametro dopo un punto interrogativo ?
. È possibile utilizzare il parametro dei risultati per controllare il numero di voci restituite, fino a 8000. In questa richiesta, viene calcolata la media di 120 risultati in due risposte.
https://api.thingspeak.com/channels/9/feeds.json?results=120&average=60
Leggi quattro voci 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 ?
.
Leggi cinque voci da un canale privato in formato JSON
Per leggere i dati da un canale privato, fornire la chiave API di lettura con il parametro api_key
. Aggiungi il primo parametro dopo un punto interrogativo ?
. Aggiungi il secondo parametro dopo una e commerciale &
. In questo caso, results
viene utilizzato per richiedere cinque risultati.
https://api.thingspeak.com/channels/9/feeds.json?api_key=E52AWRAV1RSXQQJW&results=5
Leggi un intervallo di date di eventi 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. In questo esempio, i parametri start
e end
vengono utilizzati per specificare i limiti di data per i dati richiesti.
Risposta
Errore
Per l'elenco completo, vedere Codici di errore.
Se non hai accesso al canale, la risposta è -1.