DescribeFaceVerify
当接入方移动端收到回调之后，其服务端可以调用此接口，来获取相应的认证状态和认证资料
服务地址：
华东1 金融云
输入参数
只看必填
SceneId认证场景ID
CertifyId实人认证唯一标识
PictureReturnType图片返回类型
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 服务地址：cloudauth.aliyuncs.com。
  • 请求方法：HTTPS POST 和 GET。

请求参数

字段名称字段详情
SceneIdinteger<int64>

认证场景 ID。

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:1000000006
CertifyIdstring

实人认证唯一标识。

示例值:91707dc296d469ad38e4c5efa6a0f24b
PictureReturnTypestring

图片返回类型。

示例值:JPG

返回参数

字段名称字段详情
Codestring

返回码：200 为成功，其他为失败。

示例值:200
Messagestring

错误信息

示例值:success
RequestIdstring

请求 ID。

示例值:130A2C10-B9EE-4D84-88E3-5384FF039795
ResultObjectobject

返回的结果信息

返回说明

说明 判断认证结果请以 ResultObject.Passed 或 ResultObject.SubCode 字段为准。

ResultObject.MaterialInfo 的 JSON 格式示例

  • APP 认证方案 & 活体人脸验证方案

    {
    // 是否为攻击：攻击为 T，非攻击为 F
    "faceAttack": "F",    
    // 认证的照片信息
    "facialPictureFront": {
        // 活体人脸质量分数
        "qualityScore": 88.3615493774414,
        // 人脸比对分数
        "verifyScore": 50.28594166529785,
        // 照片 https 地址，有效期 15 分钟，从查询时开始计时    
        "pictureUrl": "https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg",
        // 照片存放客户上海区域的 OSS 里，此为照片的 bucket 名
        "ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
        // 照片存放客户上海区域的 OSS 里，此为照片的文件名
        "ossObjectName": "verify/1260051251634779/6ba7bcfccf33f56cdb44ed086f36ce3e0.jpeg"   
}
}

  • 活体检测方案

    {
    // 是否为攻击：攻击为 T，非攻击为 F
    "faceAttack": "F",    
    // 认证的照片信息
    "facialPictureFront": {
        // 活体人脸质量分数
        "qualityScore": 88.3615493774414,
        // 照片 https 地址，有效期 15 分钟，从查询时开始计时    
        "pictureUrl": "https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg",
        // 照片存放客户上海区域的 OSS 里，此为照片的 bucket 名
        "ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
        // 照片存放客户上海区域的 OSS 里，此为照片的文件名
        "ossObjectName": "verify/1260051251634779/6ba7bcfccf33f56cdb44ed086f36ce3e0.jpeg"   
}
}

ResultObject.SubCode 说明

错误码认证描述文案是否计费可能原因和运营建议
200认证通过是 
201姓名和身份证不一致是可能用户的信息有误或假信息，建议用户确认后重新操作。
202查询不到身份信息是可能是用户户口迁移、军人等特殊状态导致，建议预留人工审核入口，进行人工审核。
203查询不到照片或照片不可用是可能是公安库数据问题导致，建议预留人工审核入口，进行人工审核。
204人脸比对不一致是可能不是同一人或活体照片质量较低，建议根据业务情况分层处理，若为同一人可重新操作。
205活体检测存在风险是可能存在攻击风险，建议人工审核分层处理，若为真人可重新操作。
206业务策略限制是可能存在异常风险操作，建议人工确认后操作。
变更历史
变更时间变更内容概要操作
2024-01-18
变更返回参数
2023-07-20
变更返回参数
2023-07-13
变更返回参数