Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch 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

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, max. 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
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

Tipp

Der Parameter results bestimmt die maximale Anzahl von Einträgen, die für eine Abfrage abgerufen werden sollen, bis zu 8000. Die Standardzeitspanne ist auf 1 Tag (24 Stunden) begrenzt. Um Ergebnisse von mehr als einem Tag zu erhalten und die Einträge einzuschränken, 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™ auszuführen. 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 von 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 Format JSON zurück. 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.

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

Lesen Sie vier Statusergebnisse 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/276330/status.xml?results=4

Lesen Sie fünf Statusergebnisse von einem privaten Kanal 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. Um Daten von einem privaten Kanal zu lesen, geben Sie den Read API Key nach dem Parameter api_key an. Hängen Sie den ersten Parameter nach einem Fragezeichen ? an. Verwenden Sie ein kaufmännisches Und-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 unter Verwendung von HTTP-POST-Anfragen an den Kanal