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

Read Settings

使用 HTTP GET 读取通道设置

请求

HTTP 方法

GET

URL

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

URL 参数

名称描述

<channel_id>

（必填）感兴趣通道的通道 ID。

<format>

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

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

查询字符串参数

名称描述值类型
api_key

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

字符串

响应

成功

HTTP 状态代码

200 OK

主体
GET https://api.thingspeak.com/channels/9.json

响应是公共通道 9 的 JSON 对象：

{
  "id": 9,
  "name": "my_house",
  "description": "Netduino Plus connected to sensors around the house",
  "latitude": "40.44",
  "longitude": "-79.9965",
  "created_at": "2010-12-14T01:20:06Z",
  "elevation": "",
  "last_entry_id": 11684395,
  "public_flag': true
  "url": ""
  "ranking": 100,
  "tags": [
    {
      "id": 9,
      "name": "temp"
    },
    {
      "id": 25,
      "name": "light"
    },
    {
      "id": 3,
      "name": "sensor"
    }
  ]
}
GET https://api.thingspeak.com/channels/9.xml

响应是公共通道 9 的 XML 对象：

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">9</id>
    <name>my_house</name>
    <description> Netduino Plus connected to sensors around the house.</description>
    <latitude type="decimal">40.5</latitude>
    <longitude type="decimal">-79.9965</longitude>
    <created-at type="dateTime">2010-12-14T01:20:06Z</created-at>
    <elevation></elevation>
    <last-entry-id type="integer">11684395</last-entry-id>
    <public_flag>true</public_flag>
    <url></url>
    <ranking type="integer">100</ranking>
    <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>
</channel>

错误

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

示例

查看通道设置

您可以使用 Web 浏览器对 ThingSpeak™ 的 RESTful API 完成 GET HTTP 请求。

要查看 HTTP 响应的格式，请将以下 URL 复制到 Web 浏览器的地址栏，将 <channel_ID> 更改为您的通道 ID，将 <XXXXXXXXXXXXXXXX> 更改为您的用户 API 密钥（位于 Account > My Profile 中）。

https://api.thingspeak.com/channels/<channel_ID>.json?api_key=<XXXXXXXXXXXXXXXX>

响应是通道设置的 JSON 对象，如响应部分所示。

另请参阅

函数

主题