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

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	(プライベートチャネルの場合は必須) この特定のチャネルの読み取り API キーを指定します。Read API キーは、チャネルビューのAPI Keysタブにあります。	string
results	(オプション) 取得するエントリの数、最大 8000。	整数
days	(オプション) 応答に含める現在までの 24 時間の期間の数。デフォルトは 1 です。	整数
timezone	(オプション) この要求のタイム ゾーン リファレンスの識別子。	string
offset	(オプション) 結果が表示されるタイムゾーン オフセット。より正確にするには、タイムゾーンパラメーターを使用します。	整数

ヒント

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

対応

成功

HTTPステータスコード

200 OK

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

本文

 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形式で返します。最初のパラメーターを疑問符?の後に追加します。resultsパラメーターを使用して、返されるエントリの数を最大 8000 まで制御できます。

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

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

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

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

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

csv形式で出力を要求と、返されるファイルはカンマ区切りの変数形式です。コンピューターの構成によっては、ブラウザーで追加のソフトウェアを開いてこの形式を表示できる場合があります。プライベートチャネルからデータを読み取るには、パラメーターapi_keyの後に読み取り 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要求を使用する水分センサー