华为健康服务PHP调用必须通过OAuth2授权,不可直连API;后端仅作授权中转与token管理,数据需持access_token按类型调用对应REST接口,并妥善持久化refresh_token以防失效。
华为健康服务 PHP 调用必须走 OAuth2 授权,不能直连 API
华为健康服务(Huawei Health Kit)不提供匿名或 key-based 的 HTTP 接口,所有数据读取都要求用户显式授权。PHP 作为后端,只能做「授权中转」和「token 管理」,真正的数据拉取发生在你拿到
后调用 Huawei Health Kit REST API —— 这一步必须带上用户授权 scope(比如
)。
常见错误现象:
• 直接用 cURL 请求
返回
或
• 用自己 App 的
拼 token,结果提示
—— 因为 Health Kit 不支持 client credentials 流程
必须先在华为开发者联盟配置好 OAuth2 Redirect URI(例如
),且该地址要能被公网访问
前端(App 或 H5)触发授权页:
PHP 后端收到
后,用
换取
和
,注意 body 必须是
格式
PHP 获取运动、睡眠、心率数据要用三个不同 endpoint
Health Kit 把数据按类型严格隔离,没有「统一健康数据接口」。同一个
可以复用,但请求路径、参数结构、返回字段完全不同,混用会导致 404 或字段缺失。
使用场景:你已成功换取
,现在要批量拉取用户最近 7 天数据
立即学习
“
PHP免费学习笔记(深入)
”;
运动步数:
(时间单位是毫秒,
来自 token 解析或首次 profile 查询)
睡眠记录:
(返回的是每晚一条主记录,含
数组)
心率样本:
(注意这是原始采样点,不是分钟均值)
性能影响:单次请求最大
是 200;若要拉取大范围数据,必须分页 + 时间窗口滑动,否则丢数据
refresh_token 失效快、scope 不可追加,PHP 必须持久化并预判过期
华为的
默认有效期仅 30 天,且一旦用户在华为帐号里「撤销应用权限」,所有 token 立即作废。PHP 后端如果只存一次
(2 小时过期),不做 refresh 逻辑,第二天就全量失败。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
容易踩的坑:
• 把
存 session —— 重启 PHP-FPM 就丢
• 每次都等
才去刷新 —— 用户请求已失败,体验断层
• 刷新后没更新数据库里的
和
,导致后续请求仍用旧 token
必须将
、
、
、
存入数据库(按
或
关联)
每次调用前检查
是否 POST /oauth2/v3/token 带
刷新响应里
字段可能比原始授权少(比如用户取消了心率权限),PHP 要对比并清理本地缓存的对应数据表
PHP 解析 Health Kit 返回的 timestamp 和 unit 要手动对齐
华为返回的时间戳全是毫秒级 Unix 时间(如
),但心率单位是
、步数是
、睡眠阶段用字符串(
/
),PHP 默认不处理这些语义。
示例:解析一段睡眠数据
兼容性影响:华为某些设备(如 GT 系列)返回的
可能含
或
,PHP 业务逻辑得按 type 分流,不能一概入库
最麻烦的其实是睡眠阶段定义不统一 —— 华为用 5 阶段(deep/light/rem/awake/unknown),而很多国内平台只认 3 阶段,映射时得写死规则,没法靠 API 自动适配
access_tokenhttps://www.huawei.com/health/sleep.read/v1/users/{userId}/sleep401 Unauthorized403 Forbiddenclient_secretinvalid_granthttps://yourdomain.com/huawei/callbackhttps://oauth-login.cloud.huawei.com/oauth2/v3/authorize?response_type=code&client_id={app_id}&redirect_uri={encoded_uri}&scope=https://www.huawei.com/health/sleep.read%20https://www.huawei.com/health/heart_rate.read%20https://www.huawei.com/health/steps.readcodePOST /oauth2/v3/tokenaccess_tokenrefresh_tokenapplication/x-www-form-urlencodedaccess_tokenaccess_tokenGET https://health-api.cloud.huawei.com/healthkit/v1/users/{userId}/steps?startTime=1717027200000&endTime=1717632000000&pageSize=100userIdGET https://health-api.cloud.huawei.com/healthkit/v1/users/{userId}/sleep?startTime=1717027200000&endTime=1717632000000sleepStagesGET https://health-api.cloud.huawei.com/healthkit/v1/users/{userId}/heartRate?startTime=1717027200000&endTime=1717632000000&pageSize=200pageSizerefresh_tokenaccess_tokenrefresh_token401access_tokenexpires_inrefresh_tokenaccess_tokenexpires_inscopehuawei_user_idopen_idexpires_ingrant_type=refresh_token&refresh_token={xxx}scope"startTime": 1717027200000bpmcount"awake""light"$sleep = json_decode($response_body, true);
foreach ($sleep['data'] as $item) {
$start = date('Y-m-d H:i:s', $item['startTime'] / 1000); // 必须除 1000
$stages = $item['sleepStages'] ?? [];
foreach ($stages as $stage) {
// stage['stage'] 是字符串,stage['duration'] 是毫秒,要转成秒或分钟
$minutes = $stage['duration'] / 1000 / 60;
}
}heartRate"type": "realtime""type": "average"