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

Write Data and Execute TalkBack Command

Aktualisieren Sie die Kanaldaten mit HTTP GET oder POST und führen Sie den TalkBack-Befehl aus

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 API-Schlüssel zum Schreiben auch mit einem THINGSPEAKAPIKEY-HTTP-Header senden. Der Schreib-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. Das Einfügen des TalkBack-API-Schlüssels führt dazu, dass der nächste Befehl in der Warteschlange entfernt wird und der Befehl in der Antwort zurückgegeben wird.	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
twitter	(Optional) Twitter® Benutzername, der mit ThingTweet verknüpft ist	Zeichenfolge
tweet	(Optional) Twitter Statusaktualisierung	Zeichenfolge
created_at	(Optional) Datum, an dem der Feedeintrag erstellt wurde, im Format ISO 8601 , zum Beispiel 2014-12-31 23:59:59. Muss innerhalb des Kanals eindeutig sein. Zeitzonen können mit dem Parameter timezone angegeben werden.	Terminzeit

Inhaltstyp

Content-Type ist nur für die POST-Methode erforderlich, nicht für die GET-Methode.

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

Für alle anderen Updates verwenden Sie application/x-www-form-urlencoded .

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, ist 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 mithilfe 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 Server-Antwortwert 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