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

Read Status

HTTP GETでチャネルのステータスフィールドを読み取る

要求

HTTPメソッド

GET

URL

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

URLパラメーター

名前	説明
`<channel_id>`	(必須) 関心のあるチャネルのチャネルID。
`<format>`	(オプション) HTTP 応答の形式。`json`、`xml`、または `csv` として指定します。

例: https://api.thingspeak.com/channels/266256/status.json

クエリ文字列パラメーター

名前	説明	値のタイプ
`api_key`	(プライベートチャネルの場合は必須) この特定のチャネルの Read API キーを指定します。読み取り API キーは、チャネルビューの API Keys タブにあります。	string
`results`	(オプション) 取得するエントリの数、最大 8000。	整数
`days`	(オプション) 応答に含める現在から遡った 24 時間の数。既定は 1 です。	整数
`timezone`	(オプション) この要求のタイムゾーンリファレンスからの識別子。	string
`offset`	(オプション) 結果が表示されるタイムゾーンのオフセット。精度を高めるには、タイムゾーンパラメーターを使用します。	整数

ヒント

resultsパラメーターは、クエリで取得されるエントリの最大数を 8000 まで決定します。デフォルトの時間範囲は 1 日 (24 時間) に制限されています。1 日以上にわたる結果を取得し、エントリを制限するには、results パラメータと daysパラメーターの両方を一緒に使用します。

応答

成功

HTTPステータスコード

200 OK

チャネルにアクセスできない場合、応答は -1 になります。

Body

JSONの例

GET https://api.thingspeak.com/channels/1417/status.json?results=2
or
GET  https://api.thingspeak.com/channels/1417/status?results=2

応答

The response is a JSON object of the channel statuses, for example:{
  "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の例

GET https://api.thingspeak.com/channels/1417/status.xml?results=2

応答

The response is a XML object of the channel statuses, for example:

<?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の例

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

応答

The response is a CSV object of the channel statuses, for example:

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!

エラー

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

チャネルにアクセスできない場合、応答は -1 になります。

例

Web ブラウザを使用して、ThingSpeak™ の RESTful API へのGET HTTP要求を完了できます。HTTP 応答の形式を確認するには、リンクをクリックするか、ブラウザにコピーします。

3つのステータス結果をJSON形式で読み取る

チャネル276330 には、オフィスの植物の土壌水分情報が保存されます。このパブリックチャネルからデータを読み取ることができます。応答の形式は、クエリ文字文字列パラメーターの前の URL の末尾に出現します。この例では、チャネル276330 からの最後のステータスエントリを JSON 形式で返します。最初のパラメーターを疑問符 ? の後に追加します。結果パラメーターを使用して、返されるエントリの数を最大 8000 まで制御できます。

https://api.thingspeak.com/channels/276330/status.json?results=3

4つのステータス結果をXML形式で読み取ります

この例では、形式は XML として指定されています。結果パラメーターは、設定された数のエントリ (この場合は 4 つ) を返すために使用されます。最初のパラメーターは疑問符 ? の後に追加されます。

https://api.thingspeak.com/channels/276330/status.xml?results=4

プライベートチャネルから 5 つのステータス結果を CSV 形式で読み取る

csv 形式で出力を要求と、返されるファイルはコンマ区切りの変数形式になります。コンピュータの構成によっては、ブラウザで追加のソフトウェアを開いてこの形式を表示できます。プライベートチャネルからデータを読み取るには、パラメーターapi_key の後に Read API キーを指定します。最初のパラメーターを疑問符 ? の後に追加します。2 番目のパラメーターを追加するには、アンパサンド & を使用します。この場合、resultsパラメーターを使用して 5 つの結果を返します。

https://api.thingspeak.com/channels/276330/status.csv?api_key=E52AWRAV1RSXQQJW&results=5

参考

関数

Read Data | Read Field | Write Data | Bulk Write JSON Data | Bulk Write CSV Data

トピック

チャネルへのHTTP POST要求を使用した水分センサー