Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um das englische Original zu sehen.

Read Status

Statusfeld des Kanals mit HTTP GET lesen

Anfrage

HTTP-Methode

GET

URL

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

URL-Parameter

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

Beispiel: https://api.thingspeak.com/channels/266256/status.json

Abfragezeichenfolgenparameter

Name	Beschreibung	Werttyp
api_key	(Erforderlich für private Kanäle) Geben Sie den Read-API-Schlüssel für diesen bestimmten Kanal an. Der Read-API-Schlüssel befindet sich auf der Registerkarte API Keys der Kanalansicht.	Zeichenfolge
results	(Optional) Anzahl der abzurufenden Einträge, max. 8000.	ganze Zahl
days	(Optional) Anzahl der 24-Stunden-Zeiträume vor dem aktuellen Zeitpunkt, die in die Antwort einbezogen werden sollen. Der Standardwert ist 1.	ganze Zahl
timezone	(Optional) Kennung von Zeitzonenreferenz für diese Anfrage.	Zeichenfolge
offset	(Optional) Zeitzonen-Offset, in dem die Ergebnisse angezeigt werden. Verwenden Sie den Zeitzonenparameter für eine höhere Genauigkeit.	ganze Zahl

Tipp

Der Parameter results bestimmt die maximale Anzahl der Einträge, die für eine Abfrage abgerufen werden sollen (bis zu 8000). Der Standardzeitraum ist auf 1 Tag (24 Stunden) begrenzt. Um Ergebnisse von mehr als einem Tag zu erhalten und die Einträge zu begrenzen, verwenden Sie die Parameter results und days zusammen.

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/1417/status.json?results=2 or GET https://api.thingspeak.com/channels/1417/status?results=2

Antwort The response is a JSON object of the channel statuses, for example:{ "channel": { "name": "CheerLights", "latitude": "40.5", "longitude": "-80.22" }, "feeds": [ { "created_at": "2014-02-26T02:28:01Z", "entry_id": 11888, "status": "@cheerlights green" }, { "created_at": "2014-02-26T22:05:31Z", "entry_id" :11889, "status": "@cheerlights blue" } ] }

 XML-Beispiel

GET https://api.thingspeak.com/channels/1417/status.xml?results=2

Antwort The response is a XML object of the channel statuses, for example: <?xml version="1.0" encoding="UTF-8"?> <channel> <name>CheerLights</name> <latitude type="decimal">40.5</latitude> <longitude type="decimal">-80.22</longitude> <feeds type="array"> <feed> <created-at type="dateTime">2014-02-26T02:28:01Z</created-at> <entry-id type="integer">11888</entry-id> <status>@cheerlights green</status> <id type="integer" nil="true"/> </feed> <feed> <created-at type="dateTime">2014-02-26T22:05:31Z</created-at> <entry-id type="integer">11889</entry-id> <status>@cheerlights blue</status> <id type="integer" nil="true"/> </feed> </feeds> </channel>

 CSV-Beispiel

GET https://api.thingspeak.com/channels/276330/status.csv?results=2

Antwort The response is a CSV object of the channel statuses, for example: created_at,entry_id,status 2017-10-16 15:15:12 UTC,3385,Soil is Wet. 2017-10-16 15:15:13 UTC,3386,Water needed soon!

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

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

Beispiele

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

Lesen Sie drei Statusergebnisse im JSON-Format

Kanal 276330 speichert Informationen zur Bodenfeuchtigkeit einer Büropflanze. Sie können Daten aus diesem öffentlichen Kanal lesen. Das Format für die Antwort steht am Ende der URL, vor allen Abfragezeichenfolgenparametern. Dieses Beispiel gibt den letzten Statuseintrag von Kanal 276330 im JSON-Format zurück. Hängen Sie den ersten Parameter nach einem Fragezeichen ? an. Mit dem Ergebnisparameter können Sie die Anzahl der zurückgegebenen Einträge steuern (bis zu 8000).

https://api.thingspeak.com/channels/276330/status.json?results=3

Lesen Sie vier Statusergebnisse im XML-Format

In diesem Beispiel ist das Format als XML angegeben. Der Parameter „results“ 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/276330/status.xml?results=4

Lesen Sie fünf Statusergebnisse aus einem privaten Kanal im CSV-Format

Wenn Sie die Ausgabe im csv-Format anfordern, handelt es sich bei der zurückgegebenen Datei um ein durch Kommas getrenntes Variablenformat. Abhängig von Ihrer Computerkonfiguration kann Ihr Browser zusätzliche Software öffnen, um dieses Format anzuzeigen. Um Daten aus einem privaten Kanal zu lesen, geben Sie den Read-API-Schlüssel nach dem Parameter api_key an. Hängen Sie den ersten Parameter nach einem Fragezeichen ? an. Verwenden Sie ein Et-Zeichen &, um den zweiten Parameter anzuhängen. In diesem Fall wird der Parameter results verwendet, um fünf Ergebnisse zurückzugeben.

https://api.thingspeak.com/channels/276330/status.csv?api_key=E52AWRAV1RSXQQJW&results=5

Siehe auch

Funktionen

• Read Data | Read Field | Write Data | Bulk Write JSON Data | Bulk Write CSV Data

Themen

• Feuchtigkeitssensor mit HTTP-POST-Anfragen an den Kanal