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

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

(プライベートチャネルの場合は必須)。この特定のチャネルの Read API キーを指定します。読み取り API キーは、チャネルビューの API Keys タブにあります。

string

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

(オプション) この要求の タイムゾーンリファレンス からの識別子。

string

offset

(オプション) 結果が表示されるタイムゾーンのオフセット。精度を高めるには、タイムゾーンパラメーターを使用します。

整数

status

(オプション) 「status=true」を設定して、フィードにステータスの更新を含めます。

true または false

metadata

(オプション) 「metadata=true」を設定して、チャネルのメタデータを含めます。

true または false

location

(オプション) 「location=true」を設定して、フィードに緯度、経度、標高を含めます。

true または false

min

(オプション) 応答に含める最小値。

小数

max(オプション) 応答に含める最大値。

小数

round

(オプション) 小数点以下の桁数をこの数に丸めます。

整数

timescale

(オプション) 指定した分数で最初の値を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily"。

整数または文字列

sum

(オプション) 指定した分数の合計を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily"。

整数または文字列

average

(オプション) 指定した分数の平均を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily"。メモ:平均を計算する場合、NaN 値は 0 として解釈されます。

整数または文字列

median

(オプション) 指定した分数の中央値を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily"。

integer or string

ヒント

resultsパラメーターは最も高い優先順位を持ちます。results をパラメーターmin、max、timescale、sum、average、または median と共に使用すると、返されるレコードが 8000 件未満になる可能性があります。resultsパラメーターは、クエリに使用されるエントリの最大数（最大 8000）を決定します。たとえば、1 分ごとに 1 回更新されるチャネルを考えてみましょう。パラメーター?results=120&sum=60 を使用してそのチャネルに読み取り要求を送信すると、120 レコードではなく 2 つのレコードのみが返されます。2 時間のエントリを JSON 形式で読み取り、平均を計算する の例を参照してください。

例

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

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

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

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

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

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

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

XML形式で4つのエントリを読む

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

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

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

プライベートチャネルからデータを読み取るには、パラメーター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

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"
}
]
}
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>
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 になります。

参考

関数

トピック

外部の Web サイト