Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

ステータス更新の取得

チャネルからのステータス更新を表示するには、https://api.thingspeak.com/channels/CHANNEL_ID/status.FMT に HTTP GET を送信します (CHANNEL_ID をチャネルの ID に、FMT を json または xml に置き換えます)。

有効なパラメーターは次のとおりです。

  • api_key (文字列) この特定のチャネルの Read API キー (オプション -- 公開チャネルにはキーは必要ありません)

  • timezone (文字列) この要求で使用するタイム ゾーン リファレンスの識別子 (オプション)

  • offset (整数) 結果の表示で使用するタイムゾーン オフセット。正確性を高めるには timezone パラメーターを使用します (オプション)。

  • callback (文字列) JSONP クロスドメイン要求で使用する関数名 (オプション)

JSON

チャネルからのステータス更新を表示するには、https://api.thingspeak.com/channels/CHANNEL_ID/status.json に HTTP GET を送信します (CHANNEL_ID をチャネルの ID に置き換えます)。

GET の例: 

GET https://api.thingspeak.com/channels/1417/status.json

応答はチャネル ステータスの JSON オブジェクトです。次に例を示します。 

{
  "channel":
  {
    "name": "CheerLights",
    "latitude": "40.5",
    "longitude": "-80.22"
  },
  "feeds":
  [
    {
      "created_at": "2014-02-26T02:28:01Z",
      "entry_id": 11888,
      "status": "@cheerlights green"
    },
    {
      "created_at": "2014-02-26T22:05:31Z",
      "entry_id" :11889,
      "status": "@cheerlights blue"
    }
  ]
}

XML

チャネルからのステータス更新を表示するには、https://api.thingspeak.com/channels/CHANNEL_ID/status.xml に HTTP GET を送信します (CHANNEL_ID をチャネルの ID に置き換えます)。

GET の例: 

GET https://api.thingspeak.com/channels/1417/status.xml

応答はチャネル ステータスの XML オブジェクトです。次に例を示します。 

<?xml version="1.0" encoding="UTF-8"?>
<channel>
  <name>CheerLights</name>
  <latitude type="decimal">40.5</latitude>
  <longitude type="decimal">-80.22</longitude>
  <feeds type="array">
    <feed>
      <created-at type="dateTime">2014-02-26T02:28:01Z</created-at>
      <entry-id type="integer">11888</entry-id>
      <status>@cheerlights green</status>
      <id type="integer" nil="true"/>
    </feed>
    <feed>
      <created-at type="dateTime">2014-02-26T22:05:31Z</created-at>
      <entry-id type="integer">11889</entry-id>
      <status>@cheerlights blue</status>
      <id type="integer" nil="true"/>
    </feed>
  </feeds>
</channel>

CSV

チャネルからのステータス更新を CSV 形式で表示するには、https://api.thingspeak.com/channels/CHANNEL_ID/status.csv に HTTP GET を送信します (CHANNEL_ID をチャネルの ID に置き換えます)。

GET の例: 

GET https://api.thingspeak.com/channels/276330/status.csv?results=2

応答は、チャネル ステータスの CSV オブジェクトです。次に例を示します。 

created_at,entry_id,status
2017-10-16 15:15:12 UTC,3385,Soil is Wet.
2017-10-16 15:15:13 UTC,3386,Water needed soon!