メインコンテンツ

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

Read Last Field Entry

HTTP GETでチャネルフィールドの最後のエントリを読み取る

要求

HTTPメソッド

GET

URL

https://api.thingspeak.com/channels/<channel_id>/fields/<field_id>/last.<format>

URLパラメーター

名前説明

<channel_id>

(必須) 関心のあるチャネルのチャネルID。

<field_id>

(必須) 対象フィールドのフィールド ID。

<format>

(必須) HTTP 応答の形式。jsonxmlcsv、または txt として指定されます。

例: https://api.thingspeak.com/channels/266256/fields/2/last.json

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

名前説明値のタイプ
api_key

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

string

timezone

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

string

offset

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

整数

status

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

true または false

location

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

true または false

prepend

(オプション) API 応答の前に追加するテキスト。

string
append

(オプション) API 応答の後に追加するテキスト。

string

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

JSON形式で最後のエントリを読み取る

チャネル9 には、いくつかの家庭環境センサーからの情報が含まれています。このパブリックチャネルからデータを読み取ることができます。応答の形式は、クエリ文字文字列パラメーターの前の URL の末尾に出現します。この例では、チャネル9 の最後のエントリを JSON 形式で返します。

https://api.thingspeak.com/channels/9/fields/2/last.json

XML形式で場所を含む最後のエントリを読み取ります

offsetパラメーターを含めると、ThingSpeak は GMT からの指定されたオフセットで時刻データを返します。最初のパラメーターを疑問符 ? の後に追加します。この要求は結果を XML 形式で返します。

https://api.thingspeak.com/channels/9/fields/2/last.xml?offset=3

プライベートチャネルからステータスを含む最後のエントリをCSV形式で読み取ります

csv 形式で出力を要求と、返されるファイルはコンマ区切りの変数形式になります。コンピュータの構成によっては、ブラウザがこの形式を表示するために追加のソフトウェアを起動する場合があります。プライベートチャネルから読み取るには、読み取り API キーが必要です。API キーを指定するには、クエリ文字文字列パラメーターapi_key を使用します。各エントリにはステータス フィールドもあります。この例では、status=true はフィード データとともに最後のフィールドのチャネルステータス エントリを返します。アンパサンド & の後に 2 番目のパラメーターを追加します。

https://api.thingspeak.com/channels/9/fields/2/last.csv?api_key=E52AWRAV1RSXQQJW&status=true

応答

成功

HTTPステータスコード

200 OK

Body

 テキスト例

 JSONの例

 XMLの例

 CSVの例

エラー

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

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