このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。
Read Status
HTTP GETでチャネルのステータスフィールドを読み取る
要求
HTTPメソッド
GET
URL
https://api.thingspeak.com/channels/<channel_id>/status.<format>
URLパラメーター
| 名前 | 説明 |
|---|---|
| (必須) 関心のあるチャネルのチャネルID。 |
| (オプション) HTTP 応答の形式。 |
例: 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パラメーターの両方を一緒に使用します。
応答
例
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
