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

Update TalkBack Command

Update-Befehl in der TalkBack-Warteschlange

alle in Seite erweitern

Anfrage

HTTP-Methode

PUT

URL

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

Eingabeargumente

NameBeschreibung

<talkback_id>

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

<command_id>

(Erforderlich) Befehls-ID für den betreffenden Befehl, angegeben als positive Ganzzahl.

<format>

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

Beispiel: https://api.thingspeak.com/talkbacks/12345/commands/23456.json

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

command_string

Befehl, der an Ihr Gerät gesendet werden soll. Jede Befehlszeichenfolge ist auf 255 Zeichen begrenzt.

Zeichenfolge

Inhaltstyp

application/x-www-form-urlencoded

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

Die Beispielantworten basieren auf dieser Änderung in einer Beispiel-TalkBack-Warteschlange.

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

PUT https://api.thingspeak.com/talkbacks/12345/commands/23456
    api_key=XXXXXXXXXXXXXXXX
    command_string=CLOSEDOOR
    position=2

Antwort

CLOSEDOOR
PUT https://api.thingspeak.com/talkbacks/12345/commands/23456.json
    api_key=XXXXXXXXXXXXXXXX
    command_string=CLOSEDOOR

Antwort

{
  "command_string": "OPENDOOR",
  "created_at": "2019-12-29T17:53:40-05:00",
  "executed_at": null,
  "id": 23456,
  "position": 2
}
PUT https://api.thingspeak.com/talkbacks/12345/commands/15200362.xml
    api_key=XXXXXXXXXXXXXXXX
    command_string=CLOSEDOOR
    position=2

Antwort

<?xml version="1.0" encoding="UTF-8"?>
<command>
    <id type="integer">15200362</id>
    <command-string>CLOSEDOOR</command-string>
    <position type="integer">3</position>
    <executed-at type="dateTime" nil="true"/>
    <created-at type="dateTime">2019-02-20T16:24:04Z</created-at>
</command>

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 Sie mit POSTMAN einen TalkBack-Befehl zu einer vorhandenen Warteschlange hinzufügen.

Ändern Sie den TalkBack-Befehl BUCKLESHOE in eine vorhandene TalkBack-Warteschlange mit der TalkBack-ID 15200362.

PUT https://api.thingspeak.com/talkbacks/23341/commands/15200362.xml
    api_key=XXXXXXXXXXXXXXXX
    command_string=CLOSEDOOR

  1. Wählen Sie in POSTMAN PUT aus der Dropdown-Liste der HTTP-Verben aus und geben Sie https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands/ in die Adressleiste ein. Ändern Sie TALKBACK_ID 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.

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

    • api_key, Value: XXXXXXXXXXXXXXXX

    • command_string, Value: CLOSEDOOR

Die Antwort liegt im XML-Format vor. Beachten Sie den Serverantwortwert von 200 OK, der eine erfolgreiche Aktualisierung Ihres TalkBack-Befehls anzeigt.

Der aktualisierte Befehl ist jetzt in Ihrer TalkBack-Warteschlange verfügbar.

Siehe auch

Funktionen

Themen