所有接口错误响应格式:{ "code": "error_code", "message": "描述", "detail": "可选详情", "trace_id": "追踪ID" }
| HTTP状态码 | code | 说明 |
|---|---|---|
| 400 | validation_error | 请求参数校验失败 |
| 401 | unauthorized | API Key 无效或缺失 |
| 403 | nsr_not_authorized | 税号未授权 |
| 403 | forbidden | 权限不足 |
| 404 | not_found | 资源不存在 |
| 404 | task_not_found | 任务不存在(他人任务同样返回404) |
| 404 | draft_not_found | 草稿不存在 |
| 409 | idempotency_conflict | 幂等键冲突(不同请求体) |
| 422 | balance_insufficient | 余额不足 |
| 422 | quota_exhausted | 配额耗尽 |
| 422 | daily_query_limit_exceeded | 日查询配额超限 |
| 429 | rate_limited | QPS 限流 |
| 409 | file_not_ready | 版式文件尚未生成 |
| 500 | internal_error | 服务器内部错误 |
| 503 | engine_unavailable | 引擎服务不可达 |
| 503 | engine_timeout | 引擎请求超时 |