Main Content

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

Update TalkBack Command

Befehl in der TalkBack-Warteschlange aktualisieren

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 gewünschten 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

(Erforderlicher) API-Schlüssel für diese spezifische 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. Jeder command_string 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.

 Textbeispiel

 JSON-Beispiel

 XML-Beispiel

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

alle erweitern

Sie können POSTMAN verwenden, um Ihre HTTP-Anfragen mithilfe der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie man mit POSTMAN einen TalkBack-Befehl zu einer vorhandenen Warteschlange hinzufügt.

Ä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 in 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 Server-Antwortwert 200 OK, der eine erfolgreiche Aktualisierung Ihres TalkBack-Befehls anzeigt.

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