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

主体参数

名称	描述	值类型
`api_key`	（必需）此特定 TalkBack 实例的 API 密钥。TalkBack 密钥与通道和用户 API 密钥不同。	字符串
`command_string`	要发送到您的设备的命令。每个 command_string 限制为 255 个字符。	字符串
`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

响应

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

在 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 队列。