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

Read Data

Lesen Sie Daten aus allen Feldern im Kanal mit HTTP GET

Anfrage

HTTP-Methode

GET

URL

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

URL-Parameter

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

Beispiel: https://api.thingspeak.com/channels/266256/feeds.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 Höchstzahl beträgt 8.000.	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.	Dezimal
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: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“.	integer or 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 einer Aktualisierung 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 drei Einträge im JSON-Format

Kanal 9 enthält Informationen von mehreren Sensoren für die häusliche Umgebung. Sie können Daten von diesem öffentlichen Kanal lesen. Das Format für die Antwort steht am Ende der URL, vor allen Abfragezeichenfolgenparametern. 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/feeds.json?results=3

Lesen Sie zwei Stunden lang Einträge im JSON-Format und Durchschnitt

Kanal 9 enthält Informationen von mehreren Heimumgebungssensoren und wird einmal pro Minute aktualisiert. Sie können Daten von diesem öffentlichen Kanal lesen. Das Format für die Antwort steht am Ende der URL, vor allen Abfragezeichenfolgenparametern. Hängen Sie den ersten Parameter nach einem Fragezeichen ? an. Sie können den Ergebnisparameter verwenden, um die Anzahl der zurückgegebenen Einträge zu steuern, bis zu 8000. Bei dieser Anfrage werden 120 Ergebnisse in zwei Antworten gemittelt.

https://api.thingspeak.com/channels/9/feeds.json?results=120&average=60

Lesen Sie vier Einträge im XML-Format

In diesem Beispiel wird das Format als XML angegeben. Der Ergebnisparameter wird verwendet, um eine festgelegte Anzahl von Einträgen zurückzugeben, in diesem Fall vier. Der erste Parameter wird nach einem Fragezeichen ? angehängt.

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

Lesen Sie fünf Einträge aus einem privaten Kanal im JSON-Format

Um Daten von einem privaten Kanal zu lesen, geben Sie den Read API Key mit dem Parameter api_key an. Hängen Sie den ersten Parameter nach einem Fragezeichen ? an. Hängen Sie den zweiten Parameter nach einem kaufmännischen Und-Zeichen & an. In diesem Fall wird results verwendet, um fünf Ergebnisse anzufordern.

https://api.thingspeak.com/channels/9/feeds.json?api_key=E52AWRAV1RSXQQJW&results=5

Lesen Sie einen Datumsbereich von Ereignissen im CSV-Format

Wenn Sie die Ausgabe im Format csv anfordern, ist die zurückgegebene Datei ein durch Kommas getrenntes Variablenformat. Abhängig von Ihrer Computerkonfiguration kann Ihr Browser zusätzliche Software starten, um dieses Format anzuzeigen. In diesem Beispiel werden die Parameter start und end verwendet, um Datumsgrenzen für die angeforderten Daten anzugeben.

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

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

 JSON-Beispiel

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

Die Antwort ist ein JSON-Objekt des Kanal-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:08:04Z", "last_entry_id": 13633195 }, "feeds": [ { "created_at": "2018-01-26T13:07:48Z", "entry_id": 13633194, "field1": "150", "field2": "23.014861995753716" }, { "created_at": "2018-01-26T13:08:04Z", "entry_id": 13633195, "field1": "142", "field2": "23.86411889596603" } ] }

 XML-Beispiel

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

Die Antwort ist ein XML-Objekt des Kanal-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:17:48Z</updated-at> <last-entry-id type="integer">13633230</last-entry-id> <feeds type="array"> <feed> <created-at type="dateTime">2018-01-26T13:17:33Z</created-at> <entry-id type="integer">13633229</entry-id> <field1>159</field1> <field2>20.636942675159236</field2> <id type="integer" nil="true"/> </feed> <feed> <created-at type="dateTime">2018-01-26T13:17:48Z</created-at> <entry-id type="integer">13633230</entry-id> <field1>162</field1> <field2>27.430997876857749</field2> <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 Kanal-Feeds, zum Beispiel: created_at,entry_id,field1,field2 2018-01-26 13:18:03 UTC,13633231,160,25.138004246284499 2018-01-26 13:18:18 UTC,13633232,152,28.02547770700637

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 Field | Read Status | Write Data | Bulk Write JSON Data | Bulk Write CSV Data

Themen

• Prototyping mit Sonar-Näherungssensor
• Temperaturdaten posten und vom Kanal lesen
• Kanaleigenschaften

Externe Websites

• CheerLights with Arduino and the FastLED Library