接入文档
RAW纯接口接入
双角度活体
验证侧脸
验证侧脸

# 描述

验证用户的侧脸照片。

此API必须在使用同一个API key调用的Raw-ValidateFrontFace API返回的token_front_face作为参数,否则返回400(INVALID_TOKEN)。

仅当appkey有使用网页人脸核身API服务的自拍验证权限时,才可以调用此API,否则返回错误码 403(AUTHORIZATION_ERROR:Denied)。

# 调用URL

https://api.megvii.com/faceid/lite/raw/validate_side_face

注意:在生产环境中,请使用HTTPS的通信方式。HTTP方式的通信属于不安全链路,存在安全风险,请勿在生产环境中使用。在生产环境中使用HTTP方式的,将无法得到服务可靠性保障

# 调用方法

POST  注意:用 form-data 格式请求

参数

必选/可选 参数 类型 参数说明
必选 api_key String 调用此API的api_key。
必选 api_secret String 调用此API的api_key的secret。
必选 token_front_face String Raw-ValidateFrontFace返回的token_front_face。
可选 biz_no String 用于标志一次验证流程,不超过128字符。如果要使用此参数,强烈建议对一次验证流程中调用的API(比如*Raw-ValidateFrontFace、Raw-ValidateSideFace、Raw-Verify*)使用同一个biz_no,对不同的验证流程使用不同的biz_no
必选 selfie File 用户侧脸自拍照片,侧脸照片要求用户转头的范围在20°~30°。**注:**要求上传用户的原始自拍照片,不要对图片进行额外的加工处理。特别是在微信客户端中,默认是启用压缩图片的,请注意上传原始图片。图片大小不得超过20M。

# 返回值说明

字段 类型 说明
request_id String 用于区分每一次请求的唯一的字符串。此字符串可以用于后续数据反查。此字段必定返回。
time_used Int 整个请求所花费的时间,单位为毫秒。此字段必定返回。
biz_no String **此参数仅当调用时设置了biz_no参数才返回,但是如果设置了则即使API调用失败也返回,**值与传入的biz_no保持完全一致。
token_side_face String **本字段仅调用成功才返回,**传出的token仅供Raw-Verify API调用。本字段不超过1024字节。**注意:**Token有效期为24小时
error_message String 当请求失败时才会返回此字符串,具体返回内容见后续错误信息章节。否则此字段不存在。

成功

{
 "time_used": 454,
 "biz_no": "3149525e-2c24-4862-8e9f-92040595f0a4",
 "token_side_face": "d42ec276604e3efe1289ed66adc77096",
 "request_id": "1490026118,7e08de0d-90ea-44de-a2c9-af6766927ced"
}

失败

{
 "time_used": 608,
 "biz_no": "3149525e-2c24-4862-8e9f-92040595f0a4",
 "error_message": "FACE_NOT_SIDE",
 "request_id": "1490025949,bc4e8f5c-811d-4abd-afd1-b13edfa90d0c"
}

# 错误码列表

Raw-ValidateSideFace特有的 ERROR_MESSAGE

HTTP 状态代码 错误信息 说明
400 INVALID_TOKEN 参数所对应调用Raw-ValidateFrontFace API的token_front_face不存在、或格式错误、或已过期、或并非通过一个API Key调用的Raw-ValidateFrontFace API返回的token_front_face。
400 IMAGE_ERROR_UNSUPPORTED_FORMAT 自拍图像无法正确解析,有可能不是一个图像文件、或有数据破损。
400 NO_FACE_FOUND 自拍图像没有检测到人脸。
400 MULTIPLE_FACES 自拍图像检测到多张人脸,且因大小差异不特别明显,无法确定目标脸。
400 FACE_BLURRED 人脸太模糊,不适宜活体判定或人类比对。
400 FACE_POOR_LIGHT 人脸区过亮或过暗,不适宜比对。
400 FACE_NOT_SIDE 自拍图像中的人脸非合适的侧脸照。合适的侧脸照,是指面部左右转动在15度-45度之间,面部无明显的上仰下俯,否则就会被判定为此错误。
400 FACE_NOT_PROPER_POSITION 人脸位置不合适。理想情况是人脸在画面中央,人脸包围盒的长宽分别是画面长宽的三分之一。如果实际情况偏离理想情况太多,就会触发错误,比如人脸太小或太大或位置太偏,以致于不适宜后续的活体判定和人脸比对。

通用的ERROR_MESSAGE

HTTP 状态代码 错误信息 说明
403 AUTHENTICATION_ERROR api_key 和 api_secret 不匹配。
403 AUTHORIZATION_ERROR: api_key被停用、调用次数超限、没有调用此API的权限,或者没有以当前方式调用此API的权限。目前的有:Denied. (没有权限调用当前API)
403 CONCURRENCY_LIMIT_EXCEEDED 并发数超过限制。
400 MISSING_ARGUMENTS: 缺少某个必选参数。
400 BAD_ARGUMENTS: 某个参数解析出错(比如必须是数字,但是输入的是非数字字符串; 长度过长;不允许的输入值。)
404 API_NOT_FOUND 所调用的API不存在。
500 INTERNAL_ERROR 服务器内部错误,当此类错误发生时请再次请求,如果持续出现此类错误,请及时联系 FaceID 客服或商务。
该文档未解决您的疑问?查看常见问题