このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。

Update TalkBack Command

TalkBackキューのコマンドを更新する

要求

HTTPメソッド

PUT

URL

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

入力引数

名前	説明
<talkback_id>	(必須) TalkBack ID。正の整数として指定します。
<command_id>	(必須) 対象のコマンドのコマンド ID。正の整数として指定します。
<format>	HTTP 応答の形式。 jsonまたはxmlとして指定します。

«例:» https://api.thingspeak.com/talkbacks/12345/commands/23456.json

Bodyパラメーター

名前	説明	値のタイプ
api_key	(必須) TalkBackのこの特定のインスタンスの API キー。TalkBackキーは、チャネルAPI キーやユーザー API キーとは異なります。	文字列
command_string	デバイスに送信されるコマンド。各 command_string は 255 文字に制限されます。	文字列

Content-Type

application/x-www-form-urlencoded

応答

成功

HTTPステータスコード

200 OK

Body

応答例は、サンプルTalkBackキューのこの変更に基づいています。

 テキストの例

テキスト形式で応答を受け取るには、<format>を空白のままにします。

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

応答 CLOSEDOOR

 JSON の例

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

応答 { "command_string": "OPENDOOR", "created_at": "2019-12-29T17:53:40-05:00", "executed_at": null, "id": 23456, "position": 2 }

 XML の例

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

応答 <?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>

エラー

完全なリストについては、 エラー コードを参照してください。

例

POSTMAN を使用してTalkBackコマンドを更新する

POSTMANを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。この例では、 POSTMANを使用して既存のキューにTalkBackコマンドを追加する方法を示します。

TalkBackコマンドBUCKLESHOEを、 TalkBack ID 15200362を持つ既存のTalkBackキューに変更します。

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

1. POSTMANで、HTTP 動詞のドロップダウン リストから PUT を選択し、アドレス バーにhttps://api.thingspeak.com/talkbacks/TALKBACK_ID/commands/と入力します。TALKBACK_IDをTalkBack ID に変更します。

2. パラメーターapi_keyとTalkBack API キーを入力します。このキーはApps > TalkBack> YOUR TALKBACK NAMEにあります。 $。

3. 追加のパラメーターと値を入力します。

   • api_key、 Value:XXXXXXXXXXXXXXXX

   • command_string、 Value:CLOSEDOOR

応答は XML 形式です。サーバー応答値 200 OK に注目してください。これは、 TalkBackコマンドの更新が成功したことを示します。

更新されたコマンドがTalkBackキューで使用できるようになりました。

参考

関数

• Add Command | Get Command | Get Last Command | Execute Command | Delete Command

トピック

• TalkBackアプリを使用してコマンドをキューに入れる ( MATLABより)
• ThingSpeakアプリを使用してチャネルの非アクティブを監視し、対処する
• Arduino のTalkBackでライトを制御する
• Arduinoのチャネル更新と照明制御
• ESP8266 のTalkBackでライトを制御する
• ESP8266によるチャネル更新と照明制御
• ESP32 のTalkBackでライトを制御する
• ESP32によるチャネル更新と照明制御