Polar Accesslink API调用返回403错误排查求助

核心排查方向 #

• 权限范围未授权：OAuth授权流程中必须明确请求continuous_heart_rate权限，未包含该范围的令牌会被接口拒绝，返回403。
• 令牌有效性问题：确认使用的是有效访问令牌（而非刷新令牌），同时检查令牌是否过期。可通过打印令牌内容或JWT解析工具验证有效期和权限声明。
• 查询范围违规：接口要求from和to的时间间隔不得超过30天，超出范围会触发403错误。同时确保日期格式严格为YYYY-MM-DD，无格式错误。
• 用户数据状态：确认令牌绑定的用户已同步过连续心率数据到Polar服务器，无数据时部分场景会返回403而非空响应。
• 请求头格式错误：检查Authorization头是否符合Bearer {token}格式，Bearer后必须有空格，令牌无多余字符（如换行、空格）。

代码调试技巧 #

添加日志输出关键请求信息，快速定位问题：

// 调试日志
console.log('Authorization头:', `Bearer ${token}`);
console.log('查询日期范围:', `${moment(from).format('YYYY-MM-DD')} 至 ${moment(to).format('YYYY-MM-DD')}`);

const {data} = await axios.get(
  'https://www.polaraccesslink.com/v3/users/continuous-heart-rate',
  {
    headers: {Accept: 'application/json', Authorization: `Bearer ${token}`},
    params: {
      from: moment(from).format('YYYY-MM-DD'),
      to: moment(to).format('YYYY-MM-DD'),
    },
  },
);

官方文档核心说明（翻译） #

获取连续心率样本（时间范围）

• 接口地址：GET /v3/users/continuous-heart-rate
• 必备权限：授权时需包含continuous_heart_rate范围
• 参数规则：
  • from：起始日期，格式YYYY-MM-DD
  • to：结束日期，格式YYYY-MM-DD，与from间隔不超过30天
• 响应：返回指定时段内的连续心率数据，包含时间戳及对应心率值

内容的提问来源于stack exchange，提问作者Moulie415