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

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

主体
POST https://api.thingspeak.com/channels.json
     api_key=XXXXXXXXXXXXXXXX
     name=My New Channel

响应

{
  "id": 4,
  "name": "My New Channel",
  "description": null,
  "metadata": null,
  "latitude": null,
  "longitude": null,
  "created_at": "2014-03-25T13:12:50-04:00",
  "elevation": null,
  "last_entry_id": null,
  "ranking": 15,
  "username": "iothans",
  "tags": [],
  "api_keys":
  [
    {
      "api_key": "XXXXXXXXXXXXXXXX",
      "write_flag": true
    }
  ]
}

POST https://api.thingspeak.com/channels.xml
     api_key=XXXXXXXXXXXXXXXX
     name=My New Channel

响应

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">399673</id>
    <name>MyChannel</name>
    <description nil="true"/>
    <latitude type="decimal">0.0</latitude>
    <longitude type="decimal">0.0</longitude>
    <created-at type="dateTime">2018-01-08T22:40:44Z</created-at>
    <elevation nil="true"/>
    <last-entry-id type="integer" nil="true"/>
    <public-flag type="boolean">true</public-flag>
    <url nil="true"/>
    <ranking type="integer">30</ranking>
    <metadata nil="true"/>
    <license-id type="integer">40512190</license-id>
    <tags type="array"/>
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">false</write-flag>
        </api-key>
    </api-keys>
</channel>

错误

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

示例

全部展开

您可以使用 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，表示通道创建成功。

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

另请参阅

函数

主题