Suunto API（设备线）

Suunto 走 IDeviceVendor 框架 — 非统一 action 协议，路由如下（详见 device 授权中心 与 模块文档）

路由	方法	鉴权	说明
/api/v1/device/suunto-callback	GET	state 校验	OAuth 回调（HTML 承接 → 绑定 DeviceBinding）
/api/v1/device/{vendor_id}/webhook	POST	HMAC-SHA256（X-HMAC-SHA256-Signature）	官方推送（WORKOUT_CREATED → 增量拉取；fail-loud 401）

同步与配额

• webhook 主通道 + Celery beat daily 兜底（30 天 + 临期 <30min refresh）
• Developer API 配额 10 calls/min + 200 calls/week → 详情仅对新 workout 拉取

错误码段

40417xxx（INVALID_SIGNATURE→401 / NOTIFICATION_INVALID→400）— 全表见错误码权威注册表

状态

未配 env（SUUNTO_CLIENT_ID/SECRET/SUBSCRIPTION_KEY）→ 授权中心 reviewing；配置后零代码变更转 available。