---
url: /docs/api-docs/v1/suunto.md
---
# Suunto API（设备线）

> Suunto 走 IDeviceVendor 框架 — 非统一 action 协议，路由如下（详见 [device 授权中心](/api-docs/v1/device/) 与 [模块文档](https://github.com)）

| 路由 | 方法 | 鉴权 | 说明 |
|---|---|---|---|
| `/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）— 全表见[错误码权威注册表](/ai-contexts/error-code-registry)

## 状态

未配 env（SUUNTO\_CLIENT\_ID/SECRET/SUBSCRIPTION\_KEY）→ 授权中心 `reviewing`；配置后零代码变更转 `available`。