ContrastFaceVerify_实人认证服务_API调试-阿里云OpenAPI开发者门户

接口名：ContrastFaceVerify。
服务地址：cloudauth.aliyuncs.com。
请求方法：HTTPS POST 和 GET。
接口说明：通过服务端接入实现实人认证的接口。

传入图片格式要求

当您在进行实人认证的时候，请传入满足以下所有条件的图片。

近期照片，人脸完整清晰无遮挡，表情自然，正对摄像头。
照片清晰、曝光正常，脸部无过黑、过亮、光晕等情况、角度无太大偏差。
分辨率不超过 1920*1080，至少 640*480，推荐短边缩放到 720 像素，压缩率大于 0.9。
照片大小：<1MB。
支持 90、180 和 270 度照片，多人脸的情况会选取最大脸。

请求参数

字段名称	字段详情
SceneIdinteger<int64>	认证场景 ID。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:1000000006
OuterOrderNostring	商户请求的唯一标识。展开详情示例值:e0c34a77f5ac40a5aa5e6ed20c353888
ProductCodestring	固定值：ID_MIN。示例值:ID_MIN
CertTypestring	证件类型。展开详情示例值:IDENTITY_CARD
CertNamestring	真实姓名。示例值:张三
CertNostring	证件号码。示例值:330103xxxxxxxxxxxx
FaceContrastPicturestring	照片 Base64 编码。示例值:/9j/4AAQSkZJRgABAQAASxxxxxxx
DeviceTokenstring	风险识别-设备 token。示例值:McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOxxxxxxx
Mobilestring	用户手机号码。示例值:130xxxxxxxx参考取值来源: MobileDetect
Ipstring	用户 IP。示例值:114.xxx.xxx.xxx
UserIdstring	客户业务自定义的用户 ID。示例值:123456789
FaceContrastPictureUrlstring	OSS 照片地址，目前只支持已授权 OSS 照片地址。展开详情示例值:https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg
CertifyIdstring	之前实人认证通过的 CertifyId，认证时的照片作为比对照片。展开详情示例值:0bfa7c493f850e5178b9f8613634c9xx
OssBucketNamestring	已授权 OSS 空间的 Bucket 名。展开详情示例值:cn-shanghai-aliyun-cloudauth-xxxxx
OssObjectNamestring	已授权 OSS 空间的文件名。展开详情示例值:verify/xxxxx/xxxxxx.jpeg
Modelstring
FaceContrastFilestring	参考取值来源: InitFaceVerify DescribeFaceVerify
Cropstring
EncryptTypestring

请求说明

说明如果您选择 OSS 方式传入人脸照片，您必须传入 OssBucketName 和 OssObjectName 字段。OSS 入参格式仅支持开通实人认证服务时授权的 OSS 生成的 URL、Bucket 和文件名。如果您选择 FaceContrastPicture（照片 Base64 编码）方式传入人脸照片，请注意检查照片大小，不要传入过大的照片；您可以通过 OSS 方式上传较大的人脸照片。

返回参数

字段名称	字段详情
Codestring	返回码：200 为成功，其他为失败。示例值:200
Messagestring	错误信息。示例值:success
RequestIdstring	请求 ID。示例值:130A2C10-B9EE-4D84-88E3-5384FF039795
ResultObjectobject	请求结果

返回说明

ResultObject.MaterialInfo 的 JSON 格式示例：

{
    // 是否为攻击：攻击为 T，非攻击为 F
    "faceAttack": "F",
    "facialPictureFront": {
        // 活体人脸质量分数
        "qualityScore": 88.3615493774414,
        // 人脸比对分数
        "verifyScore": 50.28594166529785
    }
}

变更历史

	变更时间	变更内容概要	操作
	2021-09-08	新增请求参数Crop