全部产品
Search
文档中心

ID Verification:服务端返回HTTP状态码说明

更新时间:Jun 23, 2026

本文介绍服务端返回的 HTTP 状态码、Code 及 Message 参数的详细说明。

HTTP 状态码

Code

Message描述

200

Success

请求成功。

400

MissingParameter

参数不能为空。

InvalidParameter

非法参数。

TransactionIdInvalid

无效Transaction id。

401

Forbidden.ExceptionRepeatedInvoke

异常重复调用次数超限。

UnqualifiedPhoto

传入的图片不可读,或图片分辨率不符合要求,建议更换图片。

需确保照片清晰、曝光正常,完整无遮挡,角度无太大偏差。

DataDuplication

同时以Base64模式与URL模式传入图片导致(人像图片传入提供三种方式,任选其一即可)。若使用了文件流模式,系统将优先按此模式执行上传。

ToolargeImage

图片尺寸过大,建议压缩图片或更换图片上传方式。

DownloadTimeout

URL图片下载超时。

NoFaceDetected

传入图片人脸特征提取失败,建议更换图片上传。

403

Forbidden.RAMUserAccessDenied

需要授予RAM用户AliyunAntCloudAuthFullAccess操作权限。更多信息,请参见授权RAM用户访问服务

Forbidden.AccountAccessDenied

请确保开通了ID Verification,并且账户未欠费。

Throttling.Api

API超过QPS限流。

404

ProcessNotCompleted

整个认证流程未完成。

429

SuspiciousActivity

安全策略限制,请重新尝试。(仅设备助手服务端接口适用)

500

InternalError

系统内部错误,请反馈工程师排查。

503

ServiceUnavailable

服务不可用,请反馈工程师排查。