错误码
错误响应保留字段 detail，并附加结构化字段 code、retryable、next_action、docs_url，供调用方程序化处理。
| HTTP 状态码 | code | 可重试 | 建议处理 |
|---|---|---|---|
| 401 | unauthorized | 否 | 提供有效的 Authorization: Bearer devnors_sk_ 密钥（在 /console 创建） |
| 402 | insufficient_balance | 否 | 余额不足;充值入口 /console（充值后可重试） |
| 400 | invalid_capability | 否 | domain/type 无效;可用组合见 /capabilities.json |
| 429 | rate_limited | 是 | 已限流;按响应头 Retry-After 秒退避后重试 |
| 501 | not_implemented | 否 | 该数据域规划中;当前可用（live）域见 /capabilities.json |
| 503 | unavailable | 是 | 服务暂不可用;可短暂退避后重试 |
| 502 | upstream_error | 是 | 数据检索失败，费用已退回;可重试 |
取数失败将自动执行幂等退款。对可重试错误（HTTP 429 及 5xx），建议依据响应头 Retry-After 或采用指数退避策略后再次请求。