SESAME 3の状態と履歴をWeb APIで取得する
2021/06/14
SESAME 3のAPIが公開されていたので触ってみた(まだ正式には発表されてはいないっぽいが)
https://doc.candyhouse.co/ja/SesameAPI
API KEYの取得
https://dash.candyhouse.co/ でログインしたら取得できる
最初「-」しか表示されていなかったけど待っていたら表示された
状態を取得
GET: "https://app.candyhouse.co/api/sesame2/{UUID}"
$ curl -s -H "x-api-key:{API KEY}" https://app.candyhouse.co/api/sesame2/{UUID} |jq
{
"batteryPercentage": 100,
"batteryVoltage": 6.116129032258065,
"position": 1069,
"CHSesame2Status": "locked",
"timestamp": 1623646157
}
履歴を取得
GET: "https://app.candyhouse.co/api/sesame2/{UUID}/history?page=1&lg=3"
$ curl -s -H "x-api-key:{API KEY}" "https://app.candyhouse.co/api/sesame2/{UUID}/history?page=1&lg=3" |jq
[
{
"recordID": 83,
"type": 2,
"timeStamp": 1623646093156,
"historyTag": "44KI44GX44GN"
},
{
"recordID": 82,
"type": 3,
"timeStamp": 1623645290000,
"parameter": "atzGYAEAAAA="
},
{
"recordID": 85,
"type": 10,
"timeStamp": 1623606552160
}
]
pageとlgは必須パラメータっぽい
pageは何ページ目を取得するか
lgは1ページに何件の履歴を取得するか