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

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 キーとは異なります。	string
`command_string`	デバイスに送信されるコマンド。各 command_string は 255 文字に制限されます。	string

Content-Type

application/x-www-form-urlencoded

応答

成功

HTTPステータスコード

200 OK

Body

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

テキスト例

JSONの例

XMLの例

エラー

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

例

すべて展開する

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

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

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

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

参考

関数

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