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

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キューのこの変更に基づいています。

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

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

応答

CLOSEDOOR
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
}
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 を使用すると、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キューで利用できるようになりました。

参考

関数

トピック