Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

Read Field

Lesen Sie Daten aus einem einzelnen Feld des Kanals mit HTTP GET

Anfrage

HTTP-Methode

GET

URL

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

URL-Parameter

Name	Beschreibung
<channel_id>	(Erforderlich) Kanal-ID für den gewünschten Kanal, angegeben als Ganzzahl.
<field_id>	(Erforderlich) Feld-ID für den Kanal von Interesse.
<format>	(Erforderlich) Format für die HTTP-Antwort, angegeben als json, xml oder csv.

Beispiel: https://api.thingspeak.com/channels/266256/fields/2.json

Parameter der Abfragezeichenfolge

Name	Beschreibung	Werttyp
api_key	(Erforderlich für private Kanäle) Geben Sie den Lese-API-Schlüssel für diesen bestimmten Kanal an. Der Lese-API-Schlüssel befindet sich auf der Registerkarte API Keys der Kanalansicht.	Zeichenfolge
results	(Optional) Anzahl der abzurufenden Einträge. Die maximale Anzahl beträgt 8000.	ganze Zahl
days	(Optional) Anzahl der bisherigen 24-Stunden-Zeiträume, die in die Antwort einbezogen werden sollen. Der Standardwert ist 1.	ganze Zahl
minutes	(Optional) Anzahl der 60-Sekunden-Perioden vor jetzt, die in die Antwort einbezogen werden sollen. Der Standardwert ist 1440.	ganze Zahl
start	(Optional) Startdatum im Format JJJJ-MM-TT%20HH:NN:SS.	Terminzeit
end	(Optional) Enddatum im Format JJJJ-MM-TT%20HH:NN:SS.	Terminzeit
timezone	(Optional) Kennung von Zeitzonen-Referenz für diese Anfrage.	Zeichenfolge
offset	(Optional) Zeitzonenoffset, in dem Ergebnisse angezeigt werden. Verwenden Sie den Zeitzonenparameter für eine höhere Genauigkeit.	ganze Zahl
status	(Optional) Fügen Sie Statusaktualisierungen in den Feed ein, indem Sie „status=true“ festlegen.	true oder false
metadata	(Optional) Fügen Sie Metadaten für einen Kanal hinzu, indem Sie „metadata=true“ festlegen.	true oder false
location	(Optional) Schließen Sie Breitengrad, Längengrad und Höhe in den Feed ein, indem Sie „location=true“ festlegen.	true oder false
min	(Optional) Mindestwert, der in die Antwort einbezogen werden soll.	true oder false
max	(Optional) Maximaler Wert, der in die Antwort einbezogen werden soll.	Dezimal
round	(Optional) Runden Sie auf diese viele Dezimalstellen.	ganze Zahl
timescale	(Optional) Erhalten Sie den ersten Wert in diesen vielen Minuten. Gültige Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“.	Ganzzahl oder Zeichenfolge
sum	(Optional) Ermitteln Sie die Summe dieser vielen Minuten, gültige Werte: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“.	Ganzzahl oder Zeichenfolge
average	(Optional) Ermitteln Sie den Durchschnitt dieser vielen Minuten. Gültige Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“. Notiz: NaN- Werte werden bei der Berechnung des Durchschnitts als 0 interpretiert.	Ganzzahl oder Zeichenfolge
median	(Optional) Ermitteln Sie den Median dieser vielen Minuten. Gültige Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“.	Ganzzahl oder string

Tipp

Der Parameter results hat die höchste Priorität. Verwendung von results mit den Parametern min, max, timescale, sum, average oder median können dazu führen, dass weniger als 8000 Datensätze zurückgegeben werden. Der Parameter results bestimmt die maximale Anzahl von Einträgen, die für eine Abfrage verwendet werden sollen, bis zu 8000. Betrachten Sie beispielsweise einen Kanal mit einem Update pro Minute. Eine Leseanforderung an diesen Kanal mit den Parametern ?results=120&sum=60 gibt nur zwei Datensätze zurück und nicht 120. Siehe das Beispiel Read Two Hours of Entries in JSON Format and Average.

Beispiele

Sie können Ihren Webbrowser verwenden, um GET-HTTP-Anfragen an die RESTful-API für ThingSpeak™ auszuführen. Um das Format einer HTTP-Antwort anzuzeigen, klicken Sie auf den Link oder kopieren Sie ihn in Ihren Browser.

Lesen Sie 10 Ergebnisse im JSON-Format

Kanal 9 enthält Informationen von mehreren Sensoren für die häusliche Umgebung. Sie können Daten aus den einzelnen Feldern dieses öffentlichen Kanals auslesen. Das Format für die Antwort steht am Ende der URL, vor allen Abfragezeichenfolgenparametern. Hier ist das angeforderte Format json. Hängen Sie den ersten Parameter nach einem Fragezeichen ? an. Mit dem Ergebnisparameter können Sie die Anzahl der zurückgegebenen Einträge steuern, die bis zu 8000 beträgt.

https://api.thingspeak.com/channels/9/fields/1.json?results=10

Lesen Sie den Medianwert alle 10 Minuten für 100 Ergebnisse im XML-Format

In diesem Beispiel wird das Format als XML angegeben. Der Ergebnisparameter wird verwendet, um eine angegebene Anzahl von Einträgen zurückzugeben, in diesem Fall 10.

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

Lesen Sie einen Datumsbereich von Ereignissen im CSV-Format

Wenn Sie die Ausgabe im csv- Format anfordern, ist die zurückgegebene Datei ein durch Kommas getrenntes Variablenformat. Abhängig von Ihrer Computerkonfiguration kann Ihr Browser zusätzliche Software öffnen, um dieses Format anzuzeigen. Verwenden Sie das kaufmännische Und-Zeichen & , um den zweiten Parameter anzuhängen. In diesem Beispiel werden die Parameter start und end verwendet, um Datumsgrenzen für die angeforderten Daten anzugeben.

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

Lesen Sie „One Day of Results“ im Textformat

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

ThingSpeak gibt den letzten Tag der Daten zurück, bis zu 8000 Punkte, wenn kein anderer Parameter angegeben ist.

Antwort

Erfolg

HTTP-Statuscode

200 OK

Wenn Sie keinen Zugriff auf den Kanal haben, lautet die Antwort -1.

Körper

 JSON-Beispiel

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

Die Antwort ist ein JSON-Objekt des Kanalfeld-Feeds, zum Beispiel: { "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" } ] }

 XML-Beispiel

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

Die Antwort ist ein XML-Objekt des Kanalfeld-Feeds, zum Beispiel: <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>

 CSV-Beispiel

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

Die Antwort ist ein CSV-Objekt des Kanalfeld-Feeds, zum Beispiel: created_at,entry_id,field1 2018-01-26 13:36:03 UTC,13633294,159 2018-01-26 13:36:19 UTC,13633295,177

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Wenn Sie keinen Zugriff auf den Kanal haben, lautet die Antwort -1.

Siehe auch

Funktionen

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

Themen

• Feuchtigkeitssensor unter Verwendung von HTTP-POST-Anfragen an den Kanal
• Kanaleigenschaften