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

Read Field

Leggi i dati da un singolo campo del canale con HTTP GET

Richiesta

Metodo HTTP

GET

URL

https://api.thingspeak.com/channels/<channel_id>/fields/<field_id>.<format>

Parametri URL

Nome	Descrizione
`<channel_id>`	(Obbligatorio) ID del canale di interesse, specificato come numero intero.
`<field_id>`	(Obbligatorio) ID campo 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/fields/2.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 è 8000.	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.	`true` o `false`
`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".	intero o `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 10 risultati in formato JSON

Il canale 9 contiene informazioni provenienti da diversi sensori dell'ambiente domestico. È possibile leggere i dati dai singoli campi di questo canale pubblico. Il formato della risposta si trova alla fine dell'URL, prima di qualsiasi parametro della stringa di query. Qui il formato richiesto è json. 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/fields/1.json?results=10

Leggi il valore mediano ogni 10 minuti per 100 risultati in formato XML

In questo esempio, il formato specificato è XML. Il parametro results viene utilizzato per restituire un numero specificato di voci, in questo caso 10.

https://api.thingspeak.com/channels/9/fields/2.xml?results=100&median=10

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ò aprire software aggiuntivi per visualizzare questo formato. Utilizzare la e commerciale & per aggiungere il secondo parametro. 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/fields/1.csv?start=2011-11-11%2010:10:10&end=2011-11-11%2011:11:11