Write Settings
使用 HTTP PUT 更新通道设置
请求
描述
使用此请求写入通道设置。通道设置包括通道描述、字段名称、通道位置、元数据、公共或私有状态以及通道名称。
HTTP方法
PUT
URL
https://api.thingspeak.com/channels/
<channel_id>
.<format>
URL 参数
名称 | 描述 |
---|---|
| (必需)感兴趣的通道的通道 ID。 |
| (必需)HTTP 响应的格式,指定为 |
示例: https://api.thingspeak.com/channels/266256.json
主体参数
名称 | 描述 | 值类型 |
---|---|---|
api_key | (必填)指定用户 API 密钥,您可以在 profile 中找到该密钥。此密钥与通道API 密钥不同。 | 字符串 |
description | (可选)通道的描述。 | 字符串 |
field1 | (可选)字段 1 名称。 | 细绳> |
field<X> | (可选)字段 X 名称,其中 X 是字段 ID。 | 字符串 |
latitude | (可选)纬度(以度为单位),指定为 | 小数 |
longitude | (可选)以度为单位的经度,指定为 | 小数 |
elevation | (可选)海拔(以米为单位)。 | 整数 |
metadata | (可选)通道的元数据,可以包括 JSON、XML 或任何其他数据。 | 文本 |
name | (可选)通道名称。 | 字符串 |
public_flag | (可选)通道是否公开。默认为 false。 | true 或 false |
tags | (可选)以逗号分隔的标签列表。 | 字符串 |
url | (可选)通道的网页 URL。 | 字符串 |
内容类型
application/x-www-form-urlencoded
示例
使用POSTMAN写入通道设置
您可以使用 POSTMAN 使用 ThingSpeak 的 RESTful API 来尝试 HTTP 请求。此示例演示如何使用 POSTMAN 写入新的通道设置。
使用现有通道,将通道名称更改为 Updated Channel
,并将字段 1 标题更改为 Heart Rate
。还将共享更改为公开。
PUT https://api.thingspeak.com/channels/CHANNEL_ID api_key=XXXXXXXXXXXXXXXX name=Updated Channel public_flag=true field1=Heart Rate
在 POSTMAN 中,从 HTTP 动词下拉列表中选择 PUT,然后在地址栏中输入
api.thingspeak.com/channels/<CHANNEL_ID>.json
,将<CHANNEL_ID>
替换为感兴趣的通道。在值栏中输入参数
api_key
,输入您的用户API密钥,该密钥可在Account 中找到>My Profile。输入附加参数和值:
name
,Value:Updated Channel
field1
,Value:Heart Rate
public_flag
,Value:True
响应采用 JSON 格式。请注意服务器响应值为 200 OK,表示新通道设置写入成功。
新的通道设置现已在您的 channels 页面上提供。