API Token 与鉴权

平台开放 API 供外部系统对接（号码管理、任务下发、话单查询等）。调用 API 需要先获取访问令牌。

获取 Token

1. 登录控制台，进入「开放接口 / API Token」；
2. 创建 Token，设置权限范围（只读 / 读写 / 指定模块）；
3. 妥善保存 Token，它只在创建时完整展示一次。

调用方式

在请求头携带令牌：

GET /openapi/v1/records?page=1
Authorization: Bearer {token}

有效性说明

• Token 有有效期，到期前请创建新 Token 并替换；
• 泄漏或人员变动时，立即在控制台吊销旧 Token；
• 单个 Token 有调用频率限制，超限返回 429，请做退避重试。

最佳实践

• 不同对接系统使用不同 Token，便于审计与最小授权；
• 不要把 Token 写死在前端代码或客户端 App 中；
• 服务端统一通过配置中心管理 Token，支持热更换。

常见错误