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

Add TalkBack Command

TalkBack-Befehl zur TalkBack-Warteschlange hinzufügen

alle in Seite erweitern

Anfrage

HTTP-Methode

POST

URL

https://api.thingspeak.com/talkbacks/<talkback_id>/commands.<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

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

position

(Optional) Die Position, an der der Befehl angezeigt werden soll. Alle vorherigen Befehle an oder nach dieser Position werden nach unten verschoben. Wenn die Position leer gelassen wird, wird der Befehl automatisch am Ende der Warteschlange mit der höchsten Position hinzugefügt.

ganze Zahl

Inhaltstyp

application/x-www-form-urlencoded

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

 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 mit der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie Sie mit POSTMAN einen TalkBack-Befehl zu einer vorhandenen Warteschlange hinzufügen.

Fügen Sie den TalkBack-Befehl LIGHTON zu einer vorhandenen TalkBack-Warteschlange mit der TalkBack-ID 24507 hinzu.

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

  1. Wählen Sie in POSTMAN POST 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: LIGHTON

Die Antwort erfolgt im Textformat. Beachten Sie den Serverantwortwert von 200 OK, der das erfolgreiche Hinzufügen des Befehls zu Ihrer TalkBack-Warteschlange anzeigt.

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

Siehe auch

Funktionen

Themen