Main Content

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

Create Channel

使用 HTTP POST 创建新通道

请求

HTTP方法

POST

URL

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

URL 参数

名称描述

<format>

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

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

主体参数

名称描述值类型
api_key

(必填)指定用户 API 密钥,您可以在 profile 中找到该密钥。此密钥与通道API 密钥不同。

字符串

description

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

字符串

field1

(可选)字段 1 名称。

字符串

fieldX

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

字符串

latitude

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

小数

longitude

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

小数

metadata

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

字符串

name

(可选)通道名称。

字符串

public_flag

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

truefalse

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

内容类型

application/x-www-form-urlencoded

响应

成功

HTTP 状态代码

200 OK

主体

 JSON 示例

 XML 示例

错误

完整列表请参见 错误代码

示例

全部展开

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

创建一个名为“我的通道”的通道,其中包含三个命名字段:“东西”、“事物”和“数据”。将 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_flagValuetrue

    • field1ValueStuff

    • field2ValueThings

    • field3ValueData

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

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

另请参阅

函数