华为健康服务php调用必须通过oauth2授权，不可直连api；后端仅作授权中转与token管理，数据需持access_token按类型调用对应rest接口，并妥善持久化refresh_token以防失效。
华为健康服务 PHP 调用必须走 OAuth2 授权，不能直连 API
华为健康服务（Huawei Health Kit）不提供匿名或 key-based 的 HTTP 接口，所有数据读取都要求用户显式授权。PHP 作为后端，只能做「授权中转」和「token 管理」，真正的数据拉取发生在你拿到 access_token 后调用 Huawei Health Kit REST API —— 这一步必须带上用户授权 scope（比如 https://www.huawei.com/health/sleep.read）。
常见错误现象：
• 直接用 cURL 请求 /v1/users/{userId}/sleep 返回 401 Unauthorized 或 403 Forbidden
• 用自己 App 的 client_secret 拼 token，结果提示 invalid_grant —— 因为 Health Kit 不支持 client credentials 流程
- 必须先在华为开发者联盟配置好 OAuth2 Redirect URI（例如
https://yourdomain.com/huawei/callback），且该地址要能被公网访问 - 前端（App 或 H5）触发授权页：
https://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.read - PHP 后端收到
code后，用POST /oauth2/v3/token换取access_token和refresh_token，注意 body 必须是application/x-www-form-urlencoded格式
PHP 获取运动、睡眠、心率数据要用三个不同 endpoint
Health Kit 把数据按类型严格隔离，没有「统一健康数据接口」。同一个 access_token 可以复用，但请求路径、参数结构、返回字段完全不同，混用会导致 404 或字段缺失。
使用场景：你已成功换取 access_token，现在要批量拉取用户最近 7 天数据
- 运动步数：
GET https://health-api.cloud.huawei.com/healthkit/v1/users/{userId}/steps?startTime=1717027200000&endTime=1717632000000&pageSize=100（时间单位是毫秒，userId来自 token 解析或首次 profile 查询） - 睡眠记录：
GET https://health-api.cloud.huawei.com/healthkit/v1/users/{userId}/sleep?startTime=1717027200000&endTime=1717632000000（返回的是每晚一条主记录，含sleepStages数组） - 心率样本：
GET https://health-api.cloud.huawei.com/healthkit/v1/users/{userId}/heartRate?startTime=1717027200000&endTime=1717632000000&pageSize=200（注意这是原始采样点，不是分钟均值）
性能影响：单次请求最大 pageSize 是 200；若要拉取大范围数据，必须分页 + 时间窗口滑动，否则丢数据
refresh_token 失效快、scope 不可追加，PHP 必须持久化并预判过期
华为的 refresh_token 默认有效期仅 30 天，且一旦用户在华为帐号里「撤销应用权限」，所有 token 立即作废。PHP 后端如果只存一次 access_token（2 小时过期），不做 refresh 逻辑，第二天就全量失败。
容易踩的坑：
• 把 refresh_token 存 session —— 重启 PHP-FPM 就丢
• 每次都等 401 才去刷新 —— 用户请求已失败，体验断层
• 刷新后没更新数据库里的 access_token 和 expires_in，导致后续请求仍用旧 token
- 必须将
refresh_token、access_token、expires_in、scope存入数据库（按huawei_user_id或open_id关联） - 每次调用前检查
expires_in是否 POST /oauth2/v3/token 带grant_type=refresh_token&refresh_token={xxx} - 刷新响应里
scope字段可能比原始授权少（比如用户取消了心率权限），PHP 要对比并清理本地缓存的对应数据表
PHP 解析 Health Kit 返回的 timestamp 和 unit 要手动对齐
华为返回的时间戳全是毫秒级 Unix 时间（如 "startTime": 1717027200000），但心率单位是 bpm、步数是 count、睡眠阶段用字符串（"awake"/"light"），PHP 默认不处理这些语义。
示例：解析一段睡眠数据
$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;
}
}
兼容性影响：华为某些设备（如 GT 系列）返回的 heartRate 可能含 "type": "realtime" 或 "type": "average"，PHP 业务逻辑得按 type 分流，不能一概入库
最麻烦的其实是睡眠阶段定义不统一 —— 华为用 5 阶段（deep/light/rem/awake/unknown），而很多国内平台只认 3 阶段，映射时得写死规则，没法靠 API 自动适配
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
