ACCUZ® Brand Guard™ / SDK 1.3.3 / HTTP API v1

HTTP 错误码与验真判定

从这里开始

HTTP 200 中可能有五种验真判定。展示前先验证完整回执;完整收到但格式、身份或编码绑定不合格时,终止为“未确认”,保留排查编号。服务返回 HTTP 错误时按下表的状态与错误码处理。网关可能不返回 JSON。

valid
标签在 decidedAt 的读取获接受。核对当前资格,展示该次接受次数。
replay
该读取已被使用。提示重新碰实体标签。
invalid_signature
未确认标签认证。显示失败结果。
unknown_tag
未识别到标签,显示中性结果。
policy_rejected
该读取未满足接受条件。保留回执判定,不增加成功次数。

HTTP

HTTP 202 表示尚在处理。遵循 Retry-After,用原键继续同一笔操作。

HTTPerror.code处理方法
400invalid_idempotency_key只传一个 Idempotency-Key 请求头。
400invalid_body按请求契约检查 JSON、编码 ID、原始地址和可选字段,URL 最长 1024 个 UTF-8 字节。
400invalid_encoding_version请管理员核对该环境和连接选用的不可变编码 ID。
400invalid_tap_url核对已批准域名、精确入口与编码模板,在重写前取得原始碰卡地址。
401not_authorized核对服务端凭据、期限、撤销状态和 API 环境。
403not_authorized核对这项 API 操作所授的权限。
403integration_not_authorized核对租户、连接、凭据状态及环境绑定。
403execute_scope_requiredPOST 需要 verifications:execute。
403read_scope_requiredGET 需要 verifications:read。仅有 execute 权限时可用原 POST 恢复。
404verification_not_found在原连接下核对回执 ID。
409idempotency_conflict同一键已绑定不同的业务输入,请取回原操作和原请求。
413body_too_largeJSON 正文最多 4096 字节。
415json_required使用 Content-Type: application/json。
429rate_limited等待 Retry-After 后恢复原操作。
503operation_busy按延迟重试同一 POST。
503retry_same_request结果未确认,保留原键、正文与 API 环境再试。
503environment_unconfigured联系环境管理员;服务恢复后继续同一笔未决操作。

参考服务诊断

查看 httpStatus、diagnosticCode、correlationId。上游完整 200 内容不合格时,本地可返回 502 并保留 httpStatus=200。仅分享支持关联号。

invalid_server_response / invalid_timestamp_response / invalid_seal_response / untrusted_identity_response / encoding_response_mismatch
完整但不合格的 HTTP 200:终态未确认,不重验。
verification_credential_rejected
HTTP 401:核对所发凭据、环境、期限与撤销状态。
verification_scope_or_origin_denied
HTTP 403:核对连接、已批准来源与所授权限。
verification_operation_conflict
HTTP 409:核对原键及业务请求。
token_required / credential_binding_missing_or_invalid
发送前的本地配置错误;提供正确的服务器 secret 绑定。
response_read_interrupted_same_request
尚未收到完整响应体,继续原操作恢复。