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.
