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

List Your Channels

使用 HTTP GET 列出您的通道

请求

HTTP 方法

GET

URL

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

输入参量

名称描述

<format>

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

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

查询字符串参数

名称描述值类型
api_key

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

字符串

tag

（可选）指定要在通道中搜索的标签。

字符串

Content-Type

application/x-www-form-urlencoded

响应

成功

HTTP 状态代码

200 OK

主体
GET https://api.thingspeak.com/channels.json?api_key=XXXXXXXXXXXXXXXX

如果您使用付费帐户，响应是您的通道的 JSON 对象，并带有 license_id 标签。例如：

[
  {
    "id": 9,
    "name": "my_house",
    "description": "Netduino Plus connected to sensors around the house",
    "latitude": "40.44",
    "longitude": "-79.996",
    "created_at": "2010-12-13T20:20:06-05:00",
    "elevation": "",
    "last_entry_id": 6062691,
    "public_flag": true
    "url": ""
    "ranking" :100,
    "metadata": "",
    "license_id": 40526371,
    "tags": [
        {
          "id": 9,
          "name": "temp"
        },
        {
          "id": 25,
          "name": "light"
        },
        {
          "id": 3,
          "name": "sensor"
        }
     ]
    "api_keys":
    [
      {
        "api_key": "XXXXXXXXXXXXXXXX",
        "write_flag": true
      }
      {
        "api_key": "YYYYYYYYYYYYYYYY",
        "write_flag": false
      }    
    ]
  },
  {
    "id": 5683,
    "name": "Residential Data Points",
    "description": "Connected Arduino",
    "latitude": "32.664548",
    "longitude": "-73.654972",
    "created_at": "2013-05-15T12:33:57-04:00",
    "elevation": "100",
    "last_entry_id": 731713,
    "public_flag": true
    "url": ""
    "ranking": 100,
    "metadata": "",
    "license_id": 40526371,
    "tags": [],
    "api_keys":
    [
      {
        "api_key": "XXXXXXXXXXXXXXXX",
        "write_flag": true
      }
      {
        "api_key": "YYYYYYYYYYYYYYYY",
        "write_flag": false
      }    
    ]
  }
]
GET https://api.thingspeak.com/channels.xml?api_key=XXXXXXXXXXXXXXXX

如果您使用付费帐户，则响应是您的通道的 XML 对象并具有 license_id 标签。例如：


<?xml version="1.0" encoding="UTF-8"?>
<channels type="array">
  <channel>
    <id type="integer">9</id>
    <name>my_house</name>
    <description>
    Netduino Plus connected to sensors around the house
    </description>
    <latitude type="decimal">40.44</latitude>
    <longitude type="decimal">-79.996</longitude>
    <created-at type="dateTime">2010-12-13T20:20:06-05:00</created-at>
    <elevation/>
    <last-entry-id type="integer">6062720</last-entry-id>
    <public-flag type="boolean">true</public-flag>
    <url/>
    <ranking type="integer">100</ranking>
    <metadata/>
    <license_id type="integer">40526371</license_id>
    <tags type="array">
        <tag>
           <id type="integer">9</id>
           <name>temp</name>
       </tag>
       <tag>
          <id type="integer">25</id>
          <name>light</name>
       </tag>
       <tag>
          <id type="integer">3</id>
          <name>sensor<name>
       </tag>
    </tags>
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
        <api-key>
            <api-key>YYYYYYYYYYYYYYYY</api-key>
            <write-flag type="boolean">false</write-flag>
        </api-key>
    </api-keys>
  </channel>
  <channel>
    <id type="integer">5683</id>
    <name>Residential Data Points</name>
    <description>Connected Arduino</description>
    <latitude type="decimal">32.664548</latitude>
    <longitude type="decimal">-73.654972</longitude>
    <created-at type="dateTime">2013-05-15T12:33:57-04:00</created-at>
    <elevation>100</elevation>
    <last-entry-id type="integer">731720</last-entry-id>
    <public-flag type="boolean">true</public-flag>
    <url/>
    <ranking type="integer">100</ranking>
    <metadata/>
    <license_id type="integer">40526371</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>YYYYYYYYYYYYYYYY</api-key>
            <write-flag type="boolean">false</write-flag>
        </api-key>
    </api-keys>
  </channel>
</channels>

错误

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

另请参阅

函数

主题