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 del 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). 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. Il numero massimo è 8.000.	intero
`days`	(Facoltativo) Numero di periodi di 24 ore precedenti ad ora da includere nella risposta. Il valore predefinito è 1.	intero
`minutes`	(Facoltativo) Numero di periodi di 60 secondi prima di adesso da includere nella risposta. Il valore predefinito è 1440.	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) Offset del fuso orario in cui vengono visualizzati i risultati. Per una maggiore precisione, utilizzare il parametro fuso orario.	intero
`status`	(Facoltativo) Includi gli aggiornamenti di stato nel feed impostando "status=true".	`true` o `false`
`metadata`	(Facoltativo) Includi i metadati per un canale impostando "metadata=true".	`true` o `false`
`location`	(Facoltativo) Includi latitudine, longitudine ed altitudine nel feed impostando "location=true".	`true` o `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.	intero
`timescale`	(Facoltativo) Ottieni il primo valore in questo numero di minuti, valori validi: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero".	intero o stringa
`sum`	(Facoltativo) Ottieni la somma di questi minuti, valori validi: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero".	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.	intero o stringa
`median`	(Facoltativo) Ottieni la mediana di questi minuti, valori validi: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero".	`integer or string`

Mancia

Il parametro results ha la precedenza più alta. L'utilizzo di results con i parametri min, max, timescale, sum, average o median può 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, consideriamo 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 Leggi due ore di voci in formato JSON e media.

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 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. Aggiungere il primo parametro dopo un punto interrogativo ?. È possibile utilizzare il parametro results 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, aggiornate 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. Aggiungere il primo parametro dopo un punto interrogativo ?. È possibile utilizzare il parametro results per controllare il numero di voci restituite, fino a 8000. In questa richiesta, la media di 120 risultati viene suddivisa 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 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/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. Aggiungere il primo parametro dopo un punto interrogativo ?. Aggiungere 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 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ò avviare software aggiuntivi 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