Gravio App API (以下 gappapi) はシンプルなHTTPSリクエストを介してHubKitに保存されているセンサーデータを提供します

URLは下記のようになります

https://[YourServerIPAddress]:29444/gappapi

次のパラメーターとフィルターを使用して、このURLにPOSTリクエストを送信します

引数
{
“DateFrom”: dateFrom,
“DateTo”: dateTo,
“OnlyNewest”: true, //only send lasts result
“AreaName”: null, //all of these are filters
“LayerName”: null, //filters
“DeviceName”: null, //filters
“LayerType”: null, //filters
“DataType”: null, //filters
“SenderId”: null //filters
}

DateFrom..データの取得開始日時
DateTo..データの取得終了日時
OnlyNewest.. 最新の1件のみを取得するかのフラグ
AreaName.. エリア名
LayerName.. レイヤー名
DeviceName.. デバイス名
LayerType.. レイヤータイプ
DataType.. データタイプ
SenderId.. 送信元ID

※日付形式は2019-12-27T23:59:59Zです

上記の引数では最新のセンサーデータをJSON形式で取得する事ができます

Postmanを使用してAPIにリクエストを発行します。

HubKitにはZigbeeを接続してセンサーは人感センサー(Aqara-Occupancy)とワイヤレススイッチ(Aqara-SingleButton)を接続してデータを受信しています。

PostmanはリクエストをPOSTにして、HubkitのIPアドレスを指定してurlを入力します。 “https://[YourServerIPAddress]:29444/gappapi”
引数をBodyのrawに選択して入力欄にJSON形式で入力します。

引数
{
“DateFrom”: “2019-11-01T23:59:59Z”,
“DateTo”: “2019-11-30T23:59:59Z”,
“OnlyNewest”: false,
“AreaName”: null,
“LayerName”: null,
“DeviceName”: null,
“LayerType”: null,
“DataType”: null,
“SenderId”: null
}

サンプル1ではデータの取得範囲を2019年11月1日23:59:59Zから2019年11月30日23:59:59Zまでを指定しています。
他のパラメータはデフォルトにしていますので、期間に保存されているデータが全て取得できます。

引数
{
“DateFrom”: “2019-11-01T23:59:59Z”,
“DateTo”: “2019-11-30T23:59:59Z”,
“OnlyNewest”: false,
“AreaName”: null,
“LayerName”: null,
“DeviceName”: null,
“LayerType”: “Aqara-Occupancy”,
“DataType”: null,
“SenderId”: null
}

サンプル2ではデータの取得範囲を2019年11月1日23:59:59Zから2019年11月30日23:59:59Zまでを指定してい、
LayerTypeに“Aqara-Occupancy“を指定していますので、期間に保存されている人感センサーのデータが全て取得できます。

引数
{
“DateFrom”: “2019-11-01T23:59:59Z”,
“DateTo”: “2019-11-30T23:59:59Z”,
“OnlyNewest”: true,
“AreaName”: null,
“LayerName”: null,
“DeviceName”: null,
“LayerType”: null,
“DataType”: null,
“SenderId”: null
}

サンプル3ではデータの取得範囲を2019年11月1日23:59:59Zから2019年11月30日23:59:59Zまでを指定してい、
OnlyNewestにtrueを指定していますので、期間に保存されているデータのうち最新の1件が取得できます。

フィードバック

お役に立ちましたか?

はい いいえ
お役に立ちましたか
理由をお聞かせください
フィードバックありがとうございました

このトピックへフィードバック

送信