Main Content

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

Add TalkBack Command

TalkBack-Befehl zur TalkBack-Warteschlange hinzufügen

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

(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

position

(Optional) Die Position, an der der Befehl erscheinen soll. Alle vorherigen Befehle an oder nach dieser Position werden nach unten verschoben. Wenn die Position leer bleibt, 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 mithilfe der RESTful-API für ThingSpeak auszuprobieren. Dieses Beispiel zeigt, wie man mit POSTMAN einen TalkBack-Befehl zu einer vorhandenen Warteschlange hinzufügt.

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 in 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 Server-Antwortwert 200 OK, der anzeigt, dass der Befehl erfolgreich zu Ihrer TalkBack-Warteschlange hinzugefügt wurde.

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