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 |
---|---|
| (Erforderlich) Kanal-ID für den gewünschten Kanal. |
| (Erforderlich) Format für die HTTP-Antwort, angegeben als |
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. |
|
metadata | (Optional) Fügen Sie Metadaten für einen Kanal hinzu, indem Sie „metadata=true“ festlegen. |
|
location | (Optional) Schließen Sie Breitengrad, Längengrad und Höhe in den Feed ein, indem Sie „location=true“ festlegen. |
|
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: | 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“. |
|
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.
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.
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.
Antwort
Fehler
Die vollständige Liste finden Sie unter Fehlercodes.
Wenn Sie keinen Zugriff auf den Kanal haben, lautet die Antwort -1.