高木のブログ

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ページに何件の履歴を取得するか


ytkg

Written by ytkg, Twitter, GitHub