Main Content

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

Write Data and Execute TalkBack Command

使用 HTTP GET 或 POST 更新通道数据并执行 TalkBack 命令

请求

HTTP方法

POSTGET

URL

https://api.thingspeak.com/update.<format>

URL 参数

名称描述

<format>

HTTP 响应的格式,指定为 jsonxml

示例: https://api.thingspeak.com/update.json?api_key=XXXXXXXXXXXXXXXXtalkback_key=YYYYYYYYYYYYYYYY

主体

名称描述值类型
api_key

(必需)为此特定通道指定写入 API 密钥。您还可以使用 THINGSPEAKAPIKEY HTTP头文件发送写入 API 密钥。写入 API 密钥可在通道视图的 API Keys 选项卡上找到。

字符串

talkback_key

(必需)TalkBack 特定实例的 API 密钥。包含 TalkBack API 密钥会导致队列中的下一个命令被删除,并在响应中返回该命令。

字符串
field<X>

(可选)字段 X 数据,其中 X 是字段 ID

任何
lat

(可选)纬度(以度为单位)

小数

long

(可选)经度(以度为单位)

小数
elevation

(可选)海拔高度(米)

整数
status

(可选)状态更新消息

字符串
twitter(可选)Twitter® 链接到 ThingTweet 的用户名字符串
tweet(可选)Twitter状态更新字符串
created_at

(可选)创建源条目的日期,格式为 ISO 8601,示例2014-12-31 23:59:59。在通道内必须是唯一的。可以使用 timezone 参数指定时区。

日期时间

内容类型

仅 POST 方法需要 Content-Type,GET 方法不需要。

使用 application/json 进行 JSON 格式的更新。

使用 application/x-www-form-urlencoded 进行所有其他更新。

响应

成功

HTTP 状态代码

200 OK

主体

 文本示例

 JSON 示例

 XML 示例

错误

完整列表请参见 错误代码

示例

全部展开

您可以使用 POSTMAN 使用 ThingSpeak 的 RESTful API 来尝试 HTTP 请求。此示例演示如何使用 POSTMAN 同时更新通道并从现有队列执行 TalkBack 命令。

123 写入通道的字段 1,并返回现有 TalkBack 队列中的下一个 TalkBack 命令。

POST https://api.thingspeak.com/update
     api_key=XXXXXXXXXXXXXXXX
     talkback_key=YYYYYYYYYYYYYYYYY

  1. 在 POSTMAN 中,从 HTTP 动词下拉列表中选择 POST,然后在地址栏中输入 https://api.thingspeak.com/update

  2. 输入附加参数和值:

    • Key:api_keyValueXXXXXXXXXXXXXXXX

    • Key:talkback_keyValueYYYYYYYYYYYYYYYY

响应采用文本格式。请注意服务器响应值为 200 OK,这表示通道更新和 TalkBack 命令执行成功。

执行的命令显示在响应中。

局限性

所有时间戳必须是唯一的。您无法使用与通道中现有数据匹配的时间戳写入新数据。