华为运动健康服务(HUAWEI Health Kit)允许三方生态应用在获取用户授权后,通过REST API接口访问数据库,读取华为和生态伙伴开放的运动健康数据或写入数据到华为运动健康服务,为用户提供更加个性化的健康改善服务。如运动类App在获取授权码后可以读取华为用户的心率、步数等运动数据,最终给用户提供健康建议。
Health Kit需要用户登录和授权,需要先申请帐号服务,可以在申请帐号服务的同时创建应用,也可以为已经创建的应用开通帐号服务。创建成功后,可以在帐号服务列表里查看已创建的应用,点击条目能查看到的详细信息如下图所示。其中的APP ID,APP SECRET和回调地址后面会用到。
2. 获取授权码code
相比于其他Kit的REST API,Health Kit使用前需要获得授权码登录华为帐号后获取到授权码,多了一个获取授权码Code的步骤。
开发指南对授权码登录做了详细介绍,此处共有client_id,response_type,redirect_uri和scope共四个必传字段,其中client_id, 是在创建应用成功后自动生成的APP ID。redirect_uri 是申请帐号服务步骤中填写的“回调地址”。
在用户输入华为帐号登录授权之后,网页浏览器会跳转到redirect_uri对应的链接,并且把所需要的授权码code作为参数追加在链接后面。

看一下官网给出的示例请求,在电脑或手机浏览器中打开上述链接,都会显示如下的华为帐号登录和授权页面。

登录授权成功之后浏览器会跳转如下链接

其中接口需要用到的授权码code就是链接中请求载荷参数code的字符串值。
需要注意的是:这边控制台中的code是urlencode编码前的字符串,浏览器中的code是urlencode编码后的字符串。
在后续步骤主要使用的是urlencode编码前的code的值。(浏览器中的code需要进行urlencode解码再使用)
接下来需要通过上面获取到的授权码code,获取access_token和refresh_token。
由于使用限制,接下来的步骤不能再使用官网demo的参数进行测试了,需要创建自己的应用。然后传入自己项目相关的参数,重复上述步骤获取授权码code。
创建的应用的相关参数,都可以在“应用服务”-“帐号”下面找到,如下是创建的一个测试应用的信息页面。

client_id,redirect_url需要和获取授权码code使用的一致。
code参数是urlencode编码前的code的值。
client_secret参数是上面应用信息里的APP SECRET。


3.使用获取到的access_token测试数据相关API
由于我们上面登录授权时,申请了获取身高体重的权限,所以在此测试一下获取身高数据的接口。
参照“查询最新采样数据”的文档链接,按照文档中postman请求测试结果如下:

Head里面的参数:Authorization 字段值为: Bearer+‘空格’+ access_token值,形如:Bearer {access_token} ,x-client-id 的值需要和上方使用的client_id一致。
请求参数“dataTypeName”:“com.huawei.instantaneous.body_weight”在数据类型-体重-原子采样数据类型可以找到:
ffcK9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3k6r3g2$3k6h3I4G2M7r3#2W2L8Y4c8Q4x3V1k6t1e0g2y4o6L8%4u0W2i4K6u0V1f1X3g2X3k6i4u0W2L8X3y4W2M7#2)9J5c8X3I4S2N6r3g2K6N6q4)9J5k6s2y4S2L8i4m8D9k6i4y4W2N6q4)9J5k6o6l9H3x3o6l9H3x3o6p5H3y4K6R3J5y4K6x3I4y4U0j5`.

如果要同时查询多个数据,请求url示例如下:
d93K9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6Z5k6h3q4D9N6r3S2Q4x3X3c8S2M7r3W2Q4x3X3g2U0L8r3!0#2k6q4)9J5k6h3S2#2j5i4N6W2K9g2)9J5k6h3y4G2L8g2)9J5c8X3S2W2j5h3I4@1K9r3E0A6N6q4)9J5c8Y4j5I4i4K6u0r3M7$3q4E0M7r3I4W2f1$3g2@1M7#2)9J5c8X3I4S2N6r3g2K6N6q4y4S2L8i4m8D9k6g2m8G2K9h3&6@1i4K6y4r3k6r3q4@1j5g2c8&6M7r3g2Q4x3@1c8U0L8$3#2Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2A6L8Y4y4@1j5h3&6@1j5h3&6W2L8%4g2K6i4K6u0W2j5X3!0V1P5g2)9#2k6Y4N6W2K9h3N6Z5N6q4)9J5y4X3q4E0M7q4)9K6b7X3c8S2N6r3q4f1P5i4m8W2i4K6y4p5j5$3!0E0i4K6u0W2K9s2g2S2N6$3g2A6i4K6u0W2K9h3&6K6N6r3q4F1N6r3q4F1k6h3!0#2M7#2)9J5k6h3u0D9L8$3!0V1i4K6g2X3k6$3I4#2j5$3!0K6k6b7`.`.
链接后拼接多个dataType参数即可。
了解更多详情>>
访问华为运动健康服务联盟官网
访问华为运动健康场景解决方案
获取华为运动健康服务开发指导文档