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

Read Field

Leggi i dati dal 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 canale per il 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) 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 è 8000.	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.	true oppure false
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".	intero o 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 10 risultati in formato JSON

Il canale 9 contiene informazioni provenienti da diversi sensori dell'ambiente domestico. Puoi 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. 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/fields/1.json?results=10

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

In questo esempio, il formato è specificato come XML. Il parametro dei risultati 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 richiedi l'output nel formato csv , il file restituito è un formato variabile separato da virgole. A seconda della configurazione del computer, il browser può aprire software aggiuntivo 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

Leggi Un giorno di risultati in formato testo

https://api.thingspeak.com/channels/9/fields/1?api_key=E52AWRAV1RSXQQJW

ThingSpeak restituisce l'ultimo giorno di dati, fino a 8000 punti, quando non viene specificato nessun altro parametro.

Risposta

Successo

Codice di stato HTTP

200 OK

Se non hai accesso al canale, la risposta è -1.

Corpo

 Esempio JSON

GET https://api.thingspeak.com/channels/9/fields/1.json?results=2 or GET https://api.thingspeak.com/channels/9/fields/1?results=2

La risposta è un oggetto JSON del feed del campo del canale, ad esempio: { "channel": { "id": 9, "name": "my_house", "description": "Netduino Plus connected to sensors around the house", "latitude": "40.44", "longitude": "-79.9965", "field1": "Light", "field2": "Outside Temperature", "created_at": "2010-12-14T01:20:06Z", "updated_at": "2018-01-26T13:35:04Z", "last_entry_id": 13633291 }, "feeds": [ { "created_at": "2018-01-26T13:34:48Z", "entry_id": 13633290, "field1": "160" }, { "created_at": "2018-01-26T13:35:04Z", "entry_id": 13633291, "field1": "167" } ] }

 Esempio XML

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

La risposta è un oggetto XML del feed del campo canale, ad esempio: <channel> <id type="integer">9</id> <name>my_house</name> <description> Netduino Plus connected to sensors around the house </description> <latitude type="decimal">40.44</latitude> <longitude type="decimal">-79.9965</longitude> <field1>Light</field1> <field2>Outside Temperature</field2> <created-at type="dateTime">2010-12-14T01:20:06Z</created-at> <updated-at type="dateTime">2018-01-26T13:35:04Z</updated-at> <last-entry-id type="integer">13633291</last-entry-id> <feeds type="array"> <feed> <created-at type="dateTime">2018-01-26T13:34:48Z</created-at> <entry-id type="integer">13633290</entry-id> <field1>160</field1> <id type="integer" nil="true"/> </feed> <feed> <created-at type="dateTime">2018-01-26T13:35:04Z</created-at> <entry-id type="integer">13633291</entry-id> <field1>167</field1> <id type="integer" nil="true"/> </feed> </feeds> </channel>

 Esempio CSV

GET https://api.thingspeak.com/channels/9/feeds.csv?results=2

La risposta è un oggetto CSV del feed del campo del canale, ad esempio: created_at,entry_id,field1 2018-01-26 13:36:03 UTC,13633294,159 2018-01-26 13:36:19 UTC,13633295,177

Errore

Per l'elenco completo, vedere Codici di errore.

Se non hai accesso al canale, la risposta è -1.

Vedi anche

Funzioni

• Read Data | Read Status | Write Data | Bulk Write Data

Argomenti

• Sensore di umidità che utilizza richieste HTTP POST al canale
• Proprietà del canale