身份验证

身份验证

通过 HTTPS 发送 JSON 请求，在 X-API-Key 中提供完整 API 密钥。密钥只保存在服务端，不放入浏览器代码、移动应用、源码仓库或日志。无需发送 App 登录 token、Bearer token 或另一份 API secret；这些接口仅用 X-API-Key 认证。当前不提供 OAuth 接入。

请求头

Content-Type: application/json
X-API-Key: <your-api-key>

密钥保存与管理

新密钥只在创建或轮换成功时完整显示一次，列表只显示掩码标识。丢失后无法找回，请更换并撤销无法使用的密钥；新密钥不会自动获得更大的权限。

新密钥默认有效期为 365 天，也可选择其他未来到期时间或永久。永久密钥仍可暂停、撤销。请在 API Keys 检查到期时间；自动到期提醒尚未开放。

暂停可恢复，撤销不可恢复。轮换生成权限相同的新密钥，请在旧密钥交叠期限内完成切换。默认交叠 24 小时，最长 7 天，也可立即撤销旧密钥。

权限

查询运费

labels.read 或 labels.buy

购买面单

labels.buy

申请取消面单

labels.buy

这三条兼容接口保留原权限规则：labels.read 或 labels.buy 可查价；labels.buy 同时允许买标和取消面单。规划中的 labels.void 等新权限不会替换或扩大这些授权，旧密钥也不会自动获得新 scope 或新资源权限。目前只可使用现有接口的 Live 密钥，新资源权限契约与测试密钥尚未开放。

返回结果

响应格式为 { code, message, data }。同时检查 HTTP 状态和响应 code，不要将服务商错误当作购买成功。