本文介绍核身认证移动端查询GetRealPersonVerificationResult的语法及示例。

功能描述

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

前提条件

调试

您可以在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小时后会被系统自动清理删除。