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

Execute TalkBack Command

Führen Sie den nächsten TalkBack-Befehl in der TalkBack-Warteschlange aus

alle in Seite erweitern

Anfrage

HTTP-Methode

GET or POST

URL

https://api.thingspeak.com/talkbacks/<talkback_id>/commands/execute.<format>

Eingabeargumente

NameBeschreibung

<talkback_id>

(Erforderlich) TalkBack-ID, angegeben als positive Ganzzahl.

<format>

Format für die HTTP-Antwort, angegeben als json oder xml.

Beispiel: https://api.thingspeak.com/talkbacks/12345/commands/execute

Körperparameter

NameBeschreibungWerttyp
api_key

(Erforderlich) API-Schlüssel für diese spezielle Instanz von TalkBack. Der TalkBack-Schlüssel unterscheidet sich von den Kanal- und Benutzer-API-Schlüsseln.

Zeichenfolge

Inhaltstyp

application/x-www-form-urlencoded

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

Die Beispielantworten basieren auf dieser Beispiel-TalkBack-Warteschlange.

Lassen Sie <format> leer, um die Antwort im Textformat zu erhalten.

POST https://api.thingspeak.com/talkbacks/12345/commands/execute
     api_key=XXXXXXXXXXXXXXXX

Antwort

OPENDOOR

Wenn keine Befehle mehr auszuführen sind, ist der Antworttext leer.

POST https://api.thingspeak.com/talkbacks/12345/commands/execute.json
     api_key=XXXXXXXXXXXXXXXX

Antwort

{
  "command_string": "OPENDOOR",
  "created_at": "2018-12-29T17:53:40-05:00",
  "executed_at": "2018-12-30T17:53:40-05:00",
  "id": 2448500,
  "position": null
}

Wenn keine Befehle mehr auszuführen sind, ist die Antwort ein leeres JSON-Objekt.

POST https://api.thingspeak.com/talkbacks/12345/commands/execute.xml
     api_key=XXXXXXXXXXXXXXXX

Antwort

<?xml version="1.0" encoding="UTF-8"?>
<command>
  <id type="integer">2448500</id>
  <command-string>OPENDOOR</command-string>
  <position type="integer" nil="true"/>
  <created-at type="datetime">2018-12-30T16:51:17-05:00</created-at>
  <executed-at type="datetime">2018-12-31T16:51:17-05:00</executed-at>
</command>

Wenn keine Befehle mehr auszuführen sind, ist die Antwort ein leerer XML-Hash, zum Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<hash></hash>

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

alle erweitern

Sie können POSTMAN verwenden, um Ihre HTTP-Anfragen mit der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie der nächste TalkBack-Befehl in einer vorhandenen Warteschlange mit POSTMAN ausgeführt wird.

Führen Sie den TalkBack-Befehl in einer vorhandenen Warteschlange mit der TalkBack-ID 24507 aus.

POST https://api.thingspeak.com/talkbacks/24507/commands
     api_key=YOUR_TALKBACK_API_KEY

  1. Wählen Sie in POSTMAN POST aus der Dropdown-Liste der HTTP-Verben aus und geben Sie https://api.thingspeak.com/talkbacks/24507/commands/execute in die Adressleiste ein. Ändern Sie 24507 in Ihre TalkBack-ID.

  2. Geben Sie den Parameter api_key und Ihren TalkBack-API-Schlüssel ein, der sich unter Apps > TalkBack> <Your TalkBack Name> befindet.

Die Antwort liegt im JSON-Format vor. Beachten Sie den Serverantwortwert von 200 OK, der die erfolgreiche Ausführung des TalkBack-Befehls anzeigt.

Der letzte Befehl wird in der Antwort angezeigt und aus Ihrer TalkBack-Warteschlange entfernt.

Siehe auch

Funktionen

Themen