调用本接口查询认证结果。

单击查看老版本接入文档说明。

接入准备

接入该API时,请确保已经完成相应的准备工作,具体参见服务端接入准备

描述

接口名:DescribeVerifyResult

请求方法:HTTPS POST 和 GET。

接口说明:当接入方移动端收到回调之后,其服务端可以调用此接口,来获取相应的认证状态和认证资料。

适用范围:该接口适用于SDK+服务端接入、H5+服务端接入的认证方案。

请求参数

名称 类型 是否必需 描述
BizId String 对应于DescribeVerifyToken接口里传入的BizId
BizType String 对应于DescribeVerifyToken接口里传入的BizType

返回参数

名称 类型 是否必需 描述
VerifyStatus Integer 认证状态,取值:
  • -1:未认证
  • 1:认证通过
  • 2~n:各种不同原因导致的认证不通过
详细描述参见认证状态说明。
Material Map 认证材料。具体结构描述参见Material。
AuthorityComparisonScore Float 认证过程中所提交的人脸照片和权威数据的比对分,取值范围为[0,100]。置信度阈值请参见:
  • 误识率0.001%时,对应阈值95。
  • 误识率0.01%时,对应阈值90。
  • 误识率为0.1%时,对应阈值80。
  • 误识率为1%时,对应阈值为60。
说明 该字段只表示人脸与权威数据的比对结果,是个参考分,通常不建议业务上仅以该分数作为是否通过的标准。认证的综合结果请参见VerifyStatus字段。VerifyStatus的结果综合了人脸与权威数据的比对和其他多种策略,可以提高安全水位。
表 1. Material
名称 类型 是否必需 描述
FaceImageUrl String 人像正面照图片HTTP/HTTPS链接。链接地址5分钟内有效,建议业务上进行转存以免影响使用。
IdCardName String 姓名。
IdCardNumber String 身份证号。
IdCardInfo Map 身份证信息的OCR结果。具体结构描述参见表 2
说明 认证过程中如果没有身份证正面和身份证反面,则不会返回身份证信息的OCR结果。认证过程中如果有身份证正面和身份证反面,也不保证一定会返回身份证上所有的信息,因身份证拍摄问题等引起的OCR无法识别时,OCR信息就会不全,建议接入方业务上不强依赖身份证OCR信息。
表 2. IdCardInfo
名称 类型 是否必需 描述
FrontImageUrl String 身份证人像面图片HTTP/HTTPS链接。链接地址5分钟内有效,建议业务上进行转存以免影响使用。
BackImageUrl String 身份证国徽面图片HTTP/HTTPS链接。链接地址5分钟内有效,建议业务上进行转存以免影响使用。
Name String 姓名。
Number String 身份证号。
Sex String 性别。取值:
Nationality String 民族。
Address String 地址。
StartDate String 证件有效期开始时间。格式为:yyyy-MM-dd。
EndDate String 证件有效期结束时间。格式为:yyyy-MM-dd。
Authority String 签发机构。
表 3. 认证状态说明
VerifyStatus 原因说明
-1 未认证。这种状态一般是端上没有成功提交比如用户中途退出认证流程。
1 认证通过。
9 认证不通过,可能原因:非账户本人操作等可能。
10 认证不通过,可能原因:非同人操作等可能。

示例

关于使用服务端SDK开发包的示例,请参见以下具体SDK开发包文档中的认证方案说明:
请求示例
https://cloudauth.aliyuncs.com/?Action=VerifyMaterials
&RegionId=cn-hangzhou
&BizType=FVBioOnlyTest
&BizId=39ecf51e-2f81-4dc5-90ee-ff86125be683
&<[公共请求参数]>
返回示例
  • XML格式
    <?xml version='1.0' encoding='UTF-8'?>
    <VerifyMaterialsResponse>
        <Data>
    <VerifyStatus>1</VerifyStatus>
           <Material>
               <FaceImageUrl>http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg
               </FaceImageUrl>     
           </Material>
        </Data>
    </VerifyMaterialsResponse>
  • JSON格式
    {
          "VerifyStatus": "1",
          "Material": {
            "FaceImageUrl": "http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg",
            }
          },
    }