核身认证移动端查询 - 阿里云视觉智能开放平台

功能描述

核身认证移动端查询能力可以确认在证件合法且姓名匹配后，返回身份验证的用户图像信息。

前提条件

请确保您已开通人脸人体服务，若未开通服务请立即开通。
已按照App认证接入教程完成客户端数据采集。

说明本能力仅限企业认证用户开通。更多实名认证操作信息，请参见实名认证。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	GetRealPersonVerificationResult	系统规定参数。取值：GetRealPersonVerificationResult。
VerificationToken	String	是	cwek23dw24geor89230hf2rw	可信核身认证的唯一标识。
MaterialHash	String	否	dafew02dsfe	认证材料（人脸图像，如移动端采集认证后获得的人脸图像）的哈希。

返回数据


名称	类型	示例值	描述
RequestId	String	10FC953D-7C0C-4915-8949-34E3246E5B79	请求ID。
Data	Object		返回的结果数据内容。
Passed	Boolean	true	认证是否通过。 true：通过。 false：不通过。
IdentityInfo	String	{"certName":"张三","certNo":"123321199001011234","ocrInfo":{ "address": "江苏省睢宁县xxxx", "nationality": "汉", "num":"320324196207101234", "sex": "女", "name": "张三", "birth": "19620710", "issue": "宜川县公安局","endDate":"20220912","startDate":"20120912"}}	certName：本次认证通过的姓名。 certNo：本次认证通过的身份证。 ocrInfo：本次OCR识别的结果，包含如下信息： `address`：地址。 `nationality`：民族。 `num`：身份证号码。 `sex`：性别。 `name`：名称。 `birth`：生日。 `issue`：签发机关。 `endDate`：到期日。 `startDate`：发证日期。说明认证通过的信息和OCR识别的信息可能不一致。
MaterialMatch	String	T	认证材料哈希是否匹配。如果有材料哈希参数传入，匹配则返回值为T，不匹配则返回值为F。如果无材料哈希参数传入，则返回空字符串。

示例

请求示例

http(s)://[Endpoint]/?Action=GetRealPersonVerificationResult
&VerificationToken=cwek23dw24geor89230hf2rw
&MaterialHash=dafew02dsfe
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetRealPersonVerificationResultResponse>
    <RequestId>10FC953D-7C0C-4915-8949-34E3246E5B79</RequestId>
    <Data>
        <Passed>true</Passed>
        <IdentityInfo>{"certName":"张三","certNo":"123321199001011234","ocrInfo":{ "address": "江苏省睢宁县xxxx",   "nationality": "汉", "num":"320324196207101234", "sex": "女", "name": "张三", "birth": "19620710", "issue": "宜川县公安局","endDate":"20220912","startDate":"20120912"}}</IdentityInfo>
        <MaterialMatch>T</MaterialMatch>
    </Data>
</GetRealPersonVerificationResultResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "10FC953D-7C0C-4915-8949-34E3246E5B79",
  "Data" : {
    "Passed" : true,
    "IdentityInfo" : "{\"certName\":\"张三\",\"certNo\":\"123321199001011234\",\"ocrInfo\":{ \"address\": \"江苏省睢宁县xxxx\",   \"nationality\": \"汉\", \"num\":\"320324196207101234\", \"sex\": \"女\", \"name\": \"张三\", \"birth\": \"19620710\", \"issue\": \"宜川县公安局\",\"endDate\":\"20220912\",\"startDate\":\"20120912\"}}",
    "MaterialMatch" : "T"
  }
}

错误码

关于核身认证移动端查询的错误码如下表所示。


状态码	错误码	描述
200	无错误码	刷脸认证通过。
400	INVALID_PARAMETER	查询时传入参数不正确。联系接口提供方技术人员排查。例如身份证格式不正确。（Z8105）
400	NOT_SAME_PERSON	刷脸认证未通过，识别结果为非本人，请确认是否为本人再发起认证。
400	PROCESSING	刷脸认证未完成。请重试，如果一直不成功，联系接口提供方技术人员排查。
400	PROCESSING	图片安全检测不通过，请确认图片是否为正常拍摄图片。（Z1146）
400	PROCESSING	系统出错了，请您稍后再试，如果多次重试依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z5137）
400	UNABLE_GET_IMAGE	比对源不可用。远程公安网没有留底图片，无法比对。暂无解决方案。（Z1104）
400	HIGH_RISK	刷脸频次过高或失败次数过多，请您请24小时后再来尝试。（Z1114）
400	EXTRACT_FACE_FAIL	图片提取不到人脸特征，请确认图片中是否包含人脸信息。（Z1156）
400	INITIALIZE_INVALID_CERT_NAME	姓名无效，请填写正确的姓名。(Z8109)
400	INITIALIZE_INVALID_CERT_AGE	未满14周岁的用户无法使用本产品，建议人工审核。(Z8110)
400	INITIALIZE_INVALID_CERT_NO	用户身份证号码信息无效，请填写正确的身份号码信息。(Z8111)
400	QUERY_INVALID_CERTIFYID	身份认证记录不存在，该CertifyId还没有对应的身份认证提交记录。(Z8304)
400	QUERY_IMG_IS_NONE	查询不到照片或照片不可用，可能是公安库数据问题导致。(Z8305)
400	QUERY_CERTINFO_IS_NONE	查询不到身份信息，可能是用户户口迁移、军人等特殊状态导致。(Z8306)
400	QUERY_CERTINFO_ISNOT_MATCH	姓名和身份证不一致，可能是用户的信息有误或用户的信息为假信息，建议用户确认后重新操作。(Z8307)
400	QUERY_OCR_ISNOT_MATCH	使用OCR方案时，人脸与身份证上人脸比对不一致，可能人证不符或人脸照片质量较低，建议根据业务情况分层处理，若为同一人可重新操作。(Z8308)
500	SYSTEM_ERROR	查询时发生系统错误。请重试，如果依然报错，请记录好RequestId联系阿里云技术支持工程师。（Z8199）

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见：

安全声明

请确保上传的图片或文件来源符合相应的法律法规。
通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。