Write Data
使用 HTTP GET 或 POST 更新通道数据
请求
HTTP 方法
POST 或 GET
URL
https://api.thingspeak.com/update.<format>
URL 参数
| 名称 | 描述 |
|---|---|
| （必需）HTTP 响应的格式，指定为空白、 |
示例：https://api.thingspeak.com/update.json
主体
| 名称 | 描述 | 值类型 |
|---|---|---|
api_key | （必填）为此特定通道写入 API 密钥。您还可以使用_THINGSPEAKAPIKEY_ HTTP 头文件发送写入 API 密钥。写入 API 密钥位于通道视图的 API Keys 选项卡上。 | 字符串 |
field<X> | （可选）字段 X 数据，其中 X 是字段 ID | 任何值 |
lat | （可选）纬度（以度为单位），指定为 | 小数 |
long | （可选）经度（以度为单位），指定为 | 小数 |
elevation | （可选）海拔（以米为单位） | 整数 |
status | （可选）状态更新消息。 | 字符串 |
created_at | （可选）创建源条目的日期，采用 ISO 8601 格式，例如： | 日期时间 |
Content-Type
Content-Type 仅对于 POST 方法来说是必需的，对于 GET 方法来说则不需要。
application/x-www-form-urlencoded 以获取大多数更新。
application/json 用于 JSON 格式的更新。
限制
所有时间戳必须是唯一的。您不能使用与通道中现有数据匹配的时间戳写入新数据。
示例
您可以使用 Web 浏览器对 ThingSpeak™ 的 RESTful API 完成 GET HTTP 请求。注意，对于不会自动对 GET 请求进行 URL 编码的嵌入式设备或客户端，您必须在从设备发出 GET 请求之前明确对查询参数进行 URL 编码。
将 URL 复制到 Web 浏览器的地址栏，将 <write_api_key> 更改为您的用户 API 密钥，该密钥位于 Account > My Profile 中。
https://api.thingspeak.com/update.json?api_key=<write_api_key>&field1=123响应是新条目的 JSON 对象，以及来自服务器的 200 OK。
{
"channel_id": 266256,
"created_at": "2018-09-10T17:41:59Z",
"entry_id": 2,
"field1": "123",
"field2": null,
"field3": null,
"field4": null,
"field5": null,
"field6": null,
"field7": null,
"field8": null,
"latitude": null,
"longitude": null,
"elevation": null,
"status": null
}您可以使用 POSTMAN 尝试使用 ThingSpeak 的 RESTful API 发出 HTTP 请求。此示例展示如何使用 POSTMAN 将数据写入通道。
这是 HTTP 请求的格式。
POST https://api.thingspeak.com/update.json
api_key=XXXXXXXXXXXXXXXX
field1=123在 POSTMAN 中，从 HTTP 动词下拉列表中选择 POST。
在地址栏中输入
https://api.thingspeak.com/update.json。选择 Body 部分下的 x-www-form-urlencoded。
输入 Parameter
api_key和您的写入 API 密钥，该密钥可以在 Channels> API Keys 中找到。输入 Parameter
field1和 Value123。
响应是新条目的 JSON 对象，以及来自服务器的 200 OK。
您可以使用 JSON 格式将数据写入您的通道。此示例展示了 JSON 格式的 REST 调用，用于同时写入多个字段和状态信息。响应也是 JSON 格式的。
POST api.thingspeak.com/update.json
Content-Type: application/json
{
"api_key": "XXXXXXXXXXXXXXXX"
"created_at": "2018-04-23 21:36:20 +0200",
"field1": "John Johnson",
"field3": 56,
"field4": 555,
"field5": 444,
"latitude": "",
"longitude": "",
"status": "Please check in!"
}响应是新条目的 JSON 对象，以及来自服务器的 200 OK。
{
"channel_id": 12345,
"created_at": "2018-04-23 21:36:20 +0200",
"field1": "John Johnson",
"field3": 56,
"field4": 555,
"field5": 444,
"latitude": "",
"longitude": "",
"status": "Please check in!"
}
