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

Read Last Entry

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

要求

HTTPメソッド

GET

URL

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

URLパラメーター

名前説明

<channel_id>

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

<format>

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

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

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

名前説明値のタイプ
api_key

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

string

timezone

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

string

offset

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

整数

status

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

true または false

location

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

true または false

例

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

最後のエントリを読み取り、結果をJSON形式で提供する

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

https://api.thingspeak.com/channels/9/feeds/last.json

場所を含む最後のエントリを読み取り、結果を XML 形式で提供します

location=true を含めると、ThingSpeak は最後のエントリの位置情報を返します。エントリの位置情報と、Channel Settings タブで設定されるチャネルの位置情報とが異なります。最初のパラメーターを疑問符 ? の後に追加します。この要求は結果を XML 形式で返します。

https://api.thingspeak.com/channels/9/feeds/last.xml?location=true

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

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

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

応答

成功

HTTPステータスコード

200 OK

Body
GET https://api.thingspeak.com/channels/9/feeds/last.json
or GET https://api.thingspeak.com/channels/9/feeds/last.txt

.json または .txt の応答は、最新のチャネルフィードの JSON オブジェクトです。例:

{
"created_at": "2018-01-24T15:19:39Z",
"entry_id": 13622631,
"field1": "187",
"field2": "34.56475583864119"
}
GET https://api.thingspeak.com/channels/9/feeds/last.xml

応答は、最新のチャネルフィードの XML オブジェクトです。例: 

 <?xml version="1.0" encoding="UTF-8"?>
<feed>
  <created-at type="dateTime">2014-02-26T21:28:51Z</created-at>
  <entry-id type="integer">879455</entry-id>
  <field1>200</field1>
  <field2>28.365180467091296</field2>
  </feed>
GET https://api.thingspeak.com/channels/9/feeds.csv?results=2

応答は、最新のチャネルフィードの CSV オブジェクトです。例: 

created_at,entry_id,field1,field2,field3,field4,field5,field6,field7,field8
2017-10-10 22:11:30 UTC,2017-10-10 22:11:30 UTC,1564159,1564159,304,304,4.3,4.3,43,43,79.2,79.2,0.0,0.0,29.8,29.8,4.0,4.0,37,37

エラー

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

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

参考

関数

トピック