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

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 キーとは異なります。	string
`command_string`	デバイスに送信されるコマンド。各 command_string は 255 文字に制限されます。	string
`position`	(オプション) コマンドを表示する位置。この位置以降の以前のコマンドはすべて下へシフトされます。位置を空白のままにすると、コマンドは自動的にキューの末尾の最高位置に追加されます。	整数

Content-Type

application/x-www-form-urlencoded

応答

成功

HTTPステータスコード

200 OK

Body

テキスト例

JSONの例

XMLの例

エラー

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

例

すべて展開する

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

POSTMANで、HTTP 動詞のドロップダウンリストから POST を選択し、アドレスバーに https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands と入力します。TALKBACK_ID をTalkBack ID に変更します。
パラメーターapi_key とTalkBack API キー (Apps > TalkBack> YOUR TALKBACK NAME にあります) を入力します。
追加のパラメーターと値を入力します。
- api_key、Value: XXXXXXXXXXXXXXXX
- command_string、Value: LIGHTON

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

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

参考

関数

Get Command | Update Command | Execute Command | Delete Command