主要内容

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

Add TalkBack Command

将 TalkBack 命令添加到 TalkBack 队列

请求

HTTP 方法

POST

URL

https://api.thingspeak.com/talkbacks/<talkback_id>/commands.<format>

输入参量

名称描述

<talkback_id>

(必填)TalkBack ID,指定为正整数。

<format>

HTTP 响应的格式,指定为 jsonxml

示例: 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

正文

 文本示例

 JSON 示例

 XML 示例

错误

完整列表请参阅错误代码

示例

全部展开

您可以使用 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

  1. 在 POSTMAN 中,从 HTTP 动词下拉列表中选择 POST,然后在地址栏中输入 https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands。将 TALKBACK_ID 更改为您的 TalkBack ID。

  2. 输入参数 api_key 和您的 TalkBack API 密钥,该密钥可以在 Apps > TalkBack> YOUR TALKBACK NAME 中找到。

  3. 输入附加参数和值:

    • api_keyValueXXXXXXXXXXXXXXXX

    • command_stringValueLIGHTON

响应为文本格式。注意服务器响应值为 200 OK,这表示该命令已成功添加到您的 TalkBack 队列。

新命令现在可在您的 TalkBack 队列中使用。