本页采用了机器翻译。点击此处可查看最新英文版本。

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

主体参数

名称描述值类型
api_key

（必需）此特定 TalkBack 实例的 API 密钥。TalkBack 密钥与通道和用户 API 密钥不同。

字符串

command_string

要发送到您的设备的命令。每个 command_string 限制为 255 个字符。

字符串

Content-Type

application/x-www-form-urlencoded

响应

成功

HTTP 状态代码

200 OK

主体

示例响应基于示例 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 队列中可用。

另请参阅

函数

主题