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

Read Data

HTTP GETを使用してチャネル内のすべてのフィールドからデータを読み取ります

要求

HTTPメソッド

GET

URL

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

URLパラメーター

名前	説明
<channel_id>	(必須) 対象のチャネルのチャネルID。
<format>	(必須) HTTP 応答の形式。 json、 xml、またはcsvとして指定します。

≪例:≫ https://api.thingspeak.com/channels/266256/feeds.json

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

名前	説明	値のタイプ
api_key	(プライベートチャネルの場合は必須)。この特定のチャネルの読み取り API キーを指定します。Read API キーは、チャネルビューのAPI Keysタブにあります。	文字列
results	(オプション) 取得するエントリの数。最大数は 8,000 です。	整数
days	(オプション) 応答に含める現在までの 24 時間の期間の数。デフォルトは 1 です。	整数
minutes	(オプション) 応答に含める、これまでの 60 秒の期間の数。デフォルトは 1440 です。	整数
start	(オプション) YYYY-MM-DD%20HH:NN:SS 形式の開始日。	datetime
end	(オプション) YYYY-MM-DD%20HH:NN:SS 形式の終了日。	datetime
timezone	(オプション) この要求のタイム ゾーン リファレンスの識別子。	文字列
offset	(オプション) 結果が表示されるタイムゾーン オフセット。より正確にするには、タイムゾーンパラメーターを使用します。	整数
status	(オプション) 「status=true」を設定して、フィードにステータス更新を含めます。	trueまたはfalse
metadata	(オプション) 「metadata=true」を設定して、チャネルのメタデータを含めます。	trueまたはfalse
location	(オプション) 「location=true」を設定して、フィードに緯度、経度、標高を含めます。	trueまたはfalse
min	(オプション) 応答に含める最小値。	10進数
max	(オプション) 応答に含める最大値。	10進数
round	(オプション) この小数点以下の桁数に丸めます。	整数
timescale	(オプション) この分数内の最初の値を取得します。有効な値: 10、15、20、30、60、240、720、1440、「毎日」。	整数または文字列
sum	(オプション) この分数の合計を取得します。有効な値は、10、15、20、30、60、240、720、1440、「毎日」です。	整数または文字列
average	(オプション) この分数の平均を取得します。有効な値: 10、15、20、30、60、240、720、1440、「毎日」。メモ:平均を計算する場合、 NaN値は0として解釈されます。	整数または文字列
median	(オプション) この分数の中央値を取得します。有効な値は、10、15、20、30、60、240、720、1440、「毎日」です。	integer or string

ヒント

resultsパラメーターの優先順位が最も高くなります。results をパラメーターmin、 max、 timescale、 sumとともに使用する$$、 average、またはmedian、 8000 未満のレコードが返される可能性があります。resultsパラメーターは、クエリに使用されるエントリの最大数 (最大 8000) を決定します。たとえば、1 分に 1 回の更新があるチャネルについて考えてみましょう。パラメーター?results=120&sum=60を指定したそのチャネルへの読み取り要求は、120 ではなく 2 レコードのみを返します。Read Two Hours of Entries in JSON Format and Average.の例を参照してください。

例

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

JSON 形式で 3 つのエントリを読み取る

チャネル9 には、いくつかの家庭環境センサーからの情報が含まれています。このパブリックチャネルからデータを読み取ることができます。応答の形式は、URL の末尾、クエリ文字列パラメーターの前に発生します。最初のパラメーターを疑問符?の後に追加します。resultsパラメーターを使用して、返されるエントリの数を制御できます (最大 8000)。

https://api.thingspeak.com/channels/9/feeds.json?results=3

JSON 形式で 2 時間のエントリを読み取り、平均

チャネル9 には、複数の家庭環境センサーからの情報が含まれており、1 分に 1 回更新されます。このパブリックチャネルからデータを読み取ることができます。応答の形式は、URL の末尾、クエリ文字列パラメーターの前に発生します。最初のパラメーターを疑問符?の後に追加します。resultsパラメーターを使用して、返されるエントリの数を最大 8000 まで制御できます。この要求では、120 件の結果が 2 つの応答に平均化されます。

https://api.thingspeak.com/channels/9/feeds.json?results=120&average=60

XML 形式で 4 つのエントリを読み取る

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

https://api.thingspeak.com/channels/9/feeds.xml?results=4

プライベートチャネルから JSON 形式で 5 つのエントリを読み取る

プライベートチャネルからデータを読み取るには、パラメーターapi_keyを使用して読み取り API キーを指定します。最初のパラメーターを疑問符?の後に追加します。アンパサンド&の後に 2 番目のパラメーターを追加します。この場合、 resultsを使用して 5 つの結果を要求。

https://api.thingspeak.com/channels/9/feeds.json?api_key=E52AWRAV1RSXQQJW&results=5

CSV 形式でイベントの日付範囲を読み取る

csv形式で出力を要求と、返されるファイルはカンマ区切りの変数形式です。コンピュータの構成によっては、ブラウザが追加のソフトウェアを起動してこの形式を表示する場合があります。この例では、 startパラメーターとendパラメーターを使用して、要求されたデータの日付制限を指定します。

https://api.thingspeak.com/channels/9/feeds.csv?start=2011-11-11%2010:10:10&end=2011-11-11%2011:11:11

応答

成功

HTTPステータスコード

200 OK

Body

 JSON の例

GET https://api.thingspeak.com/channels/9/feeds.json?results=2 or GET https://api.thingspeak.com/channels/9/feeds?results=2

応答は、チャネル フィードの JSON オブジェクトです。次に例を示します。 { "channel": { "id": 9, "name": "my_house", "description": "Netduino Plus connected to sensors around the house", "latitude": "40.44", "longitude": "-79.9965", "field1": "Light", "field2": "Outside Temperature", "created_at": "2010-12-14T01:20:06Z", "updated_at": "2018-01-26T13:08:04Z", "last_entry_id": 13633195 }, "feeds": [ { "created_at": "2018-01-26T13:07:48Z", "entry_id": 13633194, "field1": "150", "field2": "23.014861995753716" }, { "created_at": "2018-01-26T13:08:04Z", "entry_id": 13633195, "field1": "142", "field2": "23.86411889596603" } ] }

 XML の例

GET https://api.thingspeak.com/channels/9/feeds.xml?results=2

応答は、チャネル フィードの XML オブジェクトです。次に例を示します。 <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.9965</longitude> <field1>Light</field1> <field2>Outside Temperature</field2> <created-at type="dateTime">2010-12-14T01:20:06Z</created-at> <updated-at type="dateTime">2018-01-26T13:17:48Z</updated-at> <last-entry-id type="integer">13633230</last-entry-id> <feeds type="array"> <feed> <created-at type="dateTime">2018-01-26T13:17:33Z</created-at> <entry-id type="integer">13633229</entry-id> <field1>159</field1> <field2>20.636942675159236</field2> <id type="integer" nil="true"/> </feed> <feed> <created-at type="dateTime">2018-01-26T13:17:48Z</created-at> <entry-id type="integer">13633230</entry-id> <field1>162</field1> <field2>27.430997876857749</field2> <id type="integer" nil="true"/> </feed> </feeds> </channel>

 CSVの例

GET https://api.thingspeak.com/channels/9/feeds.csv?results=2

応答は、チャネル フィードの CSV オブジェクトです。次に例を示します。 created_at,entry_id,field1,field2 2018-01-26 13:18:03 UTC,13633231,160,25.138004246284499 2018-01-26 13:18:18 UTC,13633232,152,28.02547770700637

エラー

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

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

参考

関数

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

トピック

• ソナー近接センサーによるプロトタイピング
• 温度データのポストとチャネルからの読み取り
• チャネルのプロパティ

外部の Web サイト

• CheerLights with Arduino and the FastLED Library