Main Content

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

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 响应的格式,指定为 jsonxml

示例: https://api.thingspeak.com/talkbacks/12345/commands/23456.json

主体参数

名称描述值类型
api_key

(必需)此特定 TalkBack 实例的 API 密钥。TalkBack 密钥不同于通道和用户 API 密钥。

字符串

command_string

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

字符串

内容类型

application/x-www-form-urlencoded

响应

成功

HTTP 状态代码

200 OK

主体

示例响应基于示例 TalkBack 队列中的此更改。

 文本示例

 JSON 示例

 XML 示例

错误

完整列表请参见 错误代码

示例

全部展开

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

    • command_stringValueCLOSEDOOR

响应采用 XML 格式。请注意服务器响应值为 200 OK,这表示 TalkBack 命令更新成功。

更新后的命令现在可以在 TalkBack 队列中使用。