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

Add TalkBack Command

TalkBackコマンドをTalkBackキューに追加する

要求

HTTP メソッド

POST

URL

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

入力引数

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

例: https://api.thingspeak.com/talkbacks/12345/commands

Bodyパラメーター

名前	説明	値のタイプ
api_key	(必須) TalkBackのこの特定のインスタンスの API キー。TalkBackキーは、チャネルAPI キーやユーザー API キーとは異なります。	string
command_string	デバイスに送信されるコマンド。各 command_string は 255 文字に制限されます。	string
position	(オプション) コマンドを表示する位置。この位置以降にある既存のコマンドはすべて後ろにシフトされます。位置を空白のままにすると、コマンドはキューの最上位の最後に自動的に追加されます。	整数

Content-Type

application/x-www-form-urlencoded

対応

成功

HTTPステータスコード

200 OK

本文

 テキストの例

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

POST https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands api_key=YOUR_TALKBACK_API_KEY command_string=OPENDOOR position=5

対応 2448500

 JSON の例

POST https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands.json api_key=YOUR_TALKBACK_API_KEY command_string=OPENDOOR

対応 { "id": 2448500, "command_string": "OPENDOOR", "position": 5, "executed_at": null, "created_at": "2016-08-29T15:12:36Z" }

 XML の例

POST https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands.xml api_key=YOUR_TALKBACK_API_KEY command_string=OPENDOOR&position=5

対応 <?xml version="1.0" encoding="UTF-8"?> <command> <id type="integer">2448500</id> <command-string>OPENDOOR</command-string> <position type="integer">5</position> <executed-at type="datetime" nil="true"/> <created-at type="datetime">2013-12-30T16:51:17-05:00</created-at> </command>

エラー

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

例

POSTMAN を使用してTalkBackコマンドを追加する

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

TalkBackコマンドLIGHTONをTalkBack ID 24507で既存のTalkBackキューに追加します。

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

1. POSTMANで、HTTP 動詞のドロップダウン リストから POST を選択し、アドレス バーに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: LIGHTON

応答はテキスト形式です。サーバー応答値 200 OK に注目してください。これは、コマンドがTalkBackキューに正常に追加されたことを示します。

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

参考

関数

• Get Command | Update Command | Execute Command | Delete Command

トピック

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