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

Create Channel

使用 HTTP POST 创建新通道

全页展开

请求

HTTP 方法

POST

URL

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

URL 参数

名称描述

<format>

（必需）HTTP 响应的格式，指定为 json 或 xml。

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

主体参数

名称描述值类型
api_key

（必填）指定用户 API 密钥，您可以在个人资料中找到该密钥。此密钥与通道 API 密钥不同。

字符串

description

（可选）指定发出请求的客户端的 ID 或名称。

字符串

field1

（可选）字段 1 的名称。

字符串

fieldX

（可选）字段 X 名称，其中 X 是字段 ID。

字符串

latitude

（可选）纬度（度）。

小数

longitude

（可选）经度（度）。

小数

metadata

（可选）通道的元数据，可以包括 JSON、XML 或任何其他数据。

字符串

name

（可选）通道名称。

字符串

public_flag

（可选）该通道是否为公共通道。默认值为 false。

true 或 false

tags（可选）以逗号分隔的标签列表。any
url（可选）通道的网页 URL。字符串

Content-Type

application/x-www-form-urlencoded

响应

成功

HTTP 状态代码

200 OK

主体

 JSON 示例

 XML 示例

错误

完整列表请参阅错误代码。

示例

全部展开

您可以使用 POSTMAN 尝试使用 ThingSpeak 的 RESTful API 发出 HTTP 请求。此示例展示如何使用 POSTMAN 创建新通道。

创建一个名为 "My Channel" 的通道，其中包含三个命名字段："Stuff"、"Things" 和 "Data"。通过将 public_flag 设置为 true 使该通道与所有人共享。这是请求的格式。

POST https://api.thingspeak.com/channels.json
    api_key=XXXXXXXXXXXXXXXX
    name=My Channel
    public_flag=true
    field1=Stuff
    field=Things
    field3=Data

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

  2. 输入参数 api_key 和您的用户 API 密钥，该密钥可以在 Account > My Profile 中找到。

  3. 输入附加参数和值：

    • public_flag，Value：true

    • field1，Value：Stuff

    • field2，Value：Things

    • field3，Value：Data

响应采用 JSON 格式。注意服务器响应值为 200 OK，表示通道创建成功。

新通道现已在您的通道页面上发布。

另请参阅

函数

主题