body+で計った体重をWithings APIで取得する

Withings body+ を買ったので、APIで体重を取得してみる

APIドキュメント
http://developer.withings.com/

1. withingsアカウントの登録

https://healthmate.withings.com
※ body+ 設定時に登録済みのはず

2. アプリ登録をする

• 各項目を入力し、アプリ登録
• コールバックURIは自分の管理下のURLを入れておく
• 登録後の画面で表示される下記をメモしておく
  • クライアントID
  • コンシューマーシークレット

3. authentication codeの取得

• URL: https://account.withings.com/oauth2_user/authorize2
• Parameters :
  • client_id: 2.で取得したクライアントID
  • state: 必要あれば
  • scope: アクセスデータ範囲。今回は user.metrics
  • redirect_uri: 2.で登録したコールバックURI

ブラウザで下記にアクセス

https://account.withings.com/oauth2_user/authorize2?response_type=code&client_id=[クライアントID]&state=[state]&scope=user.metrics&redirect_uri=[callbacl URL]

リダイレクトされたURLからauthentication codeを取得

http://(callbacl URL)/?code=(authentication code)

4. access tokenを取得

• URL: https://account.withings.com/oauth2/token
• Parameters :
  • grant_type: authorization_code
  • client_id: 2.で取得したクライアントID
  • client_secret: 2.で取得したコンシューマーシークレット
  • code: 3.で取得した authentication code
  • redirect_uri: 2.で登録したコールバックURI

※ authentication code 取得後、30秒以内にtokenを取得する必要があるそう。

curl でPOSTする

curl --data "grant_type=authorization_code&client_id=[クライアントID]&client_secret=[コンシューマーシークレット]&code=[authentication code]&redirect_uri=[callbacl URL]" 'https://account.withings.com/oauth2/token'

戻り値

{
    "access_token": "xxxxxxx",
    "expires_in": "10800",
    "token_type": "Bearer",
    "scope": "user.metrics",
    "refresh_token": "xxxxxxxxxxx",
    "userid": "xxxxxx"
}

5. 体重を取得する

• URL: https://wbsapi.withings.net/measure
• Parameters :
  • action: getmeas
  • meastype: 体重の場合は1
  • category: 今回は1
  • startdate: 取得範囲 timestamp
  • enddate: 取得範囲 timestamp

curlでGETする

curl 'https://wbsapi.withings.net/measure?action=getmeas&access_token=[access token]&meastype=1&category=1&startdate=1543382553&enddate=1545974553'

戻り値

{
	"status": 0,
	"body": {
		"updatetime": 1545974112,
		"timezone": "Asia/Tokyo",
		"measuregrps": [
			{
				"grpid": xxxxxxxxxx,
				"attrib": 0,
				"date": 1545918646,
				"created": 1545918680,
				"category": 1,
				"deviceid": "xxxxxxxxxxx",
				"measures": [
					{
						"value": xxxxxx,
						"type": 1,
						"unit": -3,
						"algo": xxxxxx,
						"fw": xxxxxx,
						"fm": xxxxxx
					}
				],
				"comment": null
			},
			{
				"grpid": xxxxxxxxxx,
				"attrib": 0,
				"date": 1545829628,
				"created": 1545829666,
				"category": 1,
				"deviceid": "xxxxxxxxxx",
				"measures": [
					{
						"value": xxxxxx,
						"type": 1,
						"unit": -3,
						"algo": xxxxxx,
						"fw": xxxxxx,
						"fm": xxxxxx
					}
				],
				"comment": null
			}
		]
	}
}

取得できた！

返り値の measures.algo, fw, fm あたりは ドキュメントになくて謎。