调试与错误处理
Swagger UI 调试
仅标准接口支持
Swagger UI 目前仅覆盖标准接口，专线接口（如机场快报、闪电快报）暂不支持 Swagger UI 调试。
访问 https://standard.data-api.skyviewor.host/docs 可打开 Swagger UI 交互式文档：
- 点击页面右上角 Authorize 按钮
- 在弹出框中填入
sk-d5d0542bef7e42e2b8909cb7f42af5fb（无需Bearer前缀，UI 会自动添加） - 点击 Authorize → Close
- 展开任意接口，点击 Try it out，填入参数后点击 Execute
常见错误码
| HTTP 状态码 | 含义 | 原因 |
|---|---|---|
| 200 | 成功 | 调用正常，按定价规则扣点 |
| 401 | 鉴权失败 | API Key 无效、已删除或已停用 |
| 402 | 资源点不足 | 当前账号剩余资源点不足以支付本次调用 |
| 403 | 权限不足 | 会员等级不满足接口要求 |
| 404 | 未找到 | 接口路径不存在 |
| 429 | 请求超限 | QPS 超过限制 |
| 502 | 上游不可用 | 后端数据服务暂时不可用 |
| 500 | 服务内部错误 | 服务端异常，可重试 |
密钥安全
Warning
API Key 具有扣点权限，等同于账号密码。请勿在客户端代码或公开仓库中硬编码 API Key。建议将 Key 存放在环境变量或密钥管理服务中。