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

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

JSONの例

XMLの例

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>

エラー

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

参考

関数

List Your Public Channels | List Channels | Read Settings | Write Settings

トピック

チャネルプロパティ