このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

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 キーとは異なります。

string

tag

(オプション)チャネル内で検索するタグを指定します。

string

Content-Type

application/x-www-form-urlencoded

応答

成功

HTTPステータスコード

200 OK

Body
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>

エラー

完全なリストについては、エラーコード を参照してください。

参考

関数

トピック