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

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

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".	`true` oppure `false`
`metadata`	(Facoltativo) Includi i metadati per un canale impostando "metadata=true".	`true` oppure `false`
`location`	(Facoltativo) Includi latitudine, longitudine e altitudine nel feed impostando "location=true".	`true` oppure `false`
`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 `NaN` vengono interpretati come `0` quando si calcola la media.	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".	`integer or string`

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.

https://api.thingspeak.com/channels/9/feeds.json?results=3

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 ?.

https://api.thingspeak.com/channels/9/feeds.xml?results=4

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.

https://api.thingspeak.com/channels/9/feeds.csv?start=2011-11-11%2010:10:10&end=2011-11-11%2011:11:11