HTTP 200 中可能有五种验真判定。展示前先验证完整回执;完整收到但格式、身份或编码绑定不合格时,终止为“未确认”,保留排查编号。服务返回 HTTP 错误时按下表的状态与错误码处理。网关可能不返回 JSON。
| HTTP | error.code | 处理方法 |
|---|
| 400 | invalid_idempotency_key | 只传一个 Idempotency-Key 请求头。 |
| 400 | invalid_body | 按请求契约检查 JSON、编码 ID、原始地址和可选字段,URL 最长 1024 个 UTF-8 字节。 |
| 400 | invalid_encoding_version | 请管理员核对该环境和连接选用的不可变编码 ID。 |
| 400 | invalid_tap_url | 核对已批准域名、精确入口与编码模板,在重写前取得原始碰卡地址。 |
| 401 | not_authorized | 核对服务端凭据、期限、撤销状态和 API 环境。 |
| 403 | not_authorized | 核对这项 API 操作所授的权限。 |
| 403 | integration_not_authorized | 核对租户、连接、凭据状态及环境绑定。 |
| 403 | execute_scope_required | POST 需要 verifications:execute。 |
| 403 | read_scope_required | GET 需要 verifications:read。仅有 execute 权限时可用原 POST 恢复。 |
| 404 | verification_not_found | 在原连接下核对回执 ID。 |
| 409 | idempotency_conflict | 同一键已绑定不同的业务输入,请取回原操作和原请求。 |
| 413 | body_too_large | JSON 正文最多 4096 字节。 |
| 415 | json_required | 使用 Content-Type: application/json。 |
| 429 | rate_limited | 等待 Retry-After 后恢复原操作。 |
| 503 | operation_busy | 按延迟重试同一 POST。 |
| 503 | retry_same_request | 结果未确认,保留原键、正文与 API 环境再试。 |
| 503 | environment_unconfigured | 联系环境管理员;服务恢复后继续同一笔未决操作。 |
查看 httpStatus、diagnosticCode、correlationId。上游完整 200 内容不合格时,本地可返回 502 并保留 httpStatus=200。仅分享支持关联号。