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

Write Data and Execute TalkBack Command

Kanaldaten mit HTTP GET oder POST aktualisieren und TalkBack-Befehl ausführen

Anfrage

HTTP-Methode

POST oder GET

URL

https://api.thingspeak.com/update.<format>

URL-Parameter

Name	Beschreibung
<format>	Format für die HTTP-Antwort, angegeben als json oder xml.

Beispiel: https://api.thingspeak.com/update.json?api_key=XXXXXXXXXXXXXXXXtalkback_key=YYYYYYYYYYYYYYYY

Körper

Name	Beschreibung	Werttyp
api_key	(Erforderlich) Geben Sie den Schreib-API-Schlüssel für diesen bestimmten Kanal an. Sie können den Write-API-Schlüssel auch mit einem THINGSPEAKAPIKEY-HTTP-Header senden. Der Write-API-Schlüssel befindet sich auf der Registerkarte API Keys der Kanalansicht.	Zeichenfolge
talkback_key	(Erforderlich) API-Schlüssel für eine bestimmte Instanz von TalkBack. Durch die Einbeziehung des TalkBack-API-Schlüssels wird der nächste Befehl in der Warteschlange entfernt und der Befehl in der Antwort zurückgegeben.	Zeichenfolge
field<X>	(Optional) Feld X-Daten, wobei X die Feld-ID ist	beliebig
lat	(Optional) Breitengrad in Grad	dezimal
long	(Optional) Längengrad in Grad	dezimal
elevation	(Optional) Höhe in Metern	ganze Zahl
status	(Optional) Statusaktualisierungsnachricht	Zeichenfolge
created_at	(Optional) Datum, an dem der Feed-Eintrag erstellt wurde, im ISO 8601-Format, zum Beispiel 2014-12-31 23:59:59. Muss innerhalb des Kanals eindeutig sein. Zeitzonen können mit dem Parameter „timezone“ angegeben werden.	Datum/Uhrzeit

Inhaltstyp

Content-Type wird nur für die POST-Methode benötigt, nicht für die GET-Methode.

Verwenden Sie application/json für Updates im JSON-Format.

Verwenden Sie application/x-www-form-urlencoded für alle anderen Updates.

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

 Textbeispiel

POST https://api.thingspeak.com/update api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

Antwort Die Antwort ist die Befehlszeichenfolge des nächsten TalkBack-Befehls in der TalkBack-Warteschlange mit dem angegebenen TalkBack-API-Schlüssel. Wenn das Update fehlschlägt, lautet die Antwort 0.

 JSON-Beispiel

POST https://api.thingspeak.com/update.json api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

Die Antwort ist ein JSON-Objekt des nächsten Befehls in der TalkBack-Warteschlange mit dem angegebenen TalkBack-API-Schlüssel, zum Beispiel: { "id": 15254213, "command_string": "OPENDOOR", "position": null, "executed_at": "2019-03-05T15:48:29Z", "created_at": "2019-02-26T13:45:09Z" }

 XML-Beispiel

POST https://api.thingspeak.com/update.xml api_key=XXXXXXXXXXXXXXXX field1=73 talkback_key=YYYYYYYYYYYYYYYY

Die Antwort ist ein XML-Objekt des nächsten Befehls in der TalkBack-Warteschlange mit dem angegebenen TalkBack-API-Schlüssel, zum Beispiel: <command> <id type="integer">15338752</id> <command-string>OPENDOOR</command-string> <position type="integer" nil="true"/> <executed-at type="dateTime">2019-03-05T15:52:08Z</executed-at> <created-at type="dateTime">2019-03-05T15:51:54Z</created-at> </command>

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

Verwenden Sie POSTMAN, um einen TalkBack-Befehl hinzuzufügen

Sie können POSTMAN verwenden, um Ihre HTTP-Anfragen mit der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie Sie mit POSTMAN gleichzeitig einen Kanal aktualisieren und einen TalkBack-Befehl aus einer vorhandenen Warteschlange ausführen.

Schreiben Sie 123 in Feld 1 eines Kanals und geben Sie den nächsten TalkBack-Befehl in einer vorhandenen TalkBack-Warteschlange zurück.

POST https://api.thingspeak.com/update
     api_key=XXXXXXXXXXXXXXXX
     talkback_key=YYYYYYYYYYYYYYYYY

1. Wählen Sie in POSTMAN POST aus der Dropdown-Liste der HTTP-Verben aus und geben Sie https://api.thingspeak.com/update in die Adressleiste ein.

2. Geben Sie die zusätzlichen Parameter und Werte ein:

   • Key: api_key, Value: XXXXXXXXXXXXXXXX

   • Key: talkback_key, Value: YYYYYYYYYYYYYYYY

Die Antwort erfolgt im Textformat. Beachten Sie den Serverantwortwert von 200 OK, der eine erfolgreiche Kanalaktualisierung und Ausführung des TalkBack-Befehls anzeigt.

Der ausgeführte Befehl wird in der Antwort angezeigt.

Einschränkungen

Alle Zeitstempel müssen eindeutig sein. Sie können keine neuen Daten mit Zeitstempeln schreiben, die mit vorhandenen Daten im Kanal übereinstimmen.

Siehe auch

Bulk Write Data | Add Command | Get All Commands | Update Command | Execute Command | Delete Command