Main Content

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

Write Settings

使用 HTTP PUT 更新通道设置

请求

描述

使用此请求写入通道设置。通道设置包括通道描述、字段名称、通道位置、元数据、公共或私有状态以及通道名称。

HTTP方法

PUT

URL

https://api.thingspeak.com/channels/<channel_id>.<format>

URL 参数

名称描述

<channel_id>

(必需)感兴趣的通道的通道 ID。

<format>

(必需)HTTP 响应的格式,指定为 jsonxml

示例: https://api.thingspeak.com/channels/266256.json

主体参数

名称描述值类型
api_key(必填)指定用户 API 密钥,您可以在 profile 中找到该密钥。此密钥与通道API 密钥不同。字符串
description(可选)通道的描述。字符串
field1

(可选)字段 1 名称。

细绳>
field<X>

(可选)字段 X 名称,其中 X 是字段 ID。

字符串
latitude

(可选)纬度(以度为单位),指定为 -9090 之间的值。

小数
longitude

(可选)以度为单位的经度,指定为 -180180 之间的值。

小数
elevation

(可选)海拔(以米为单位)。

整数
metadata

(可选)通道的元数据,可以包括 JSON、XML 或任何其他数据。

文本
name

(可选)通道名称。

字符串
public_flag

(可选)通道是否公开。默认为 false。

truefalse
tags

(可选)以逗号分隔的标签列表。

字符串
url

(可选)通道的网页 URL。

字符串

内容类型

application/x-www-form-urlencoded

响应

成功

HTTP 状态代码

200 OK

主体

 JSON 示例

 XML 示例

错误

完整列表请参见 错误代码

示例

使用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

  1. 在 POSTMAN 中,从 HTTP 动词下拉列表中选择 PUT,然后在地址栏中输入 api.thingspeak.com/channels/<CHANNEL_ID>.json,将 <CHANNEL_ID> 替换为感兴趣的通道。

  2. 在值栏中输入参数api_key,输入您的用户API密钥,该密钥可在Account 中找到>My Profile

  3. 输入附加参数和值:

    • nameValueUpdated Channel

    • field1ValueHeart Rate

    • public_flagValueTrue

响应采用 JSON 格式。请注意服务器响应值为 200 OK,表示新通道设置写入成功。

新的通道设置现已在您的 channels 页面上提供。

附加材料