核身认证移动端查询

本文介绍人脸人体(facebody)类目下的核身认证移动端查询GetRealPersonVerificationResult的语法及示例。

功能描述

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

说明
  • 您可以进入在线咨询获取在线人工帮助。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

接入指引

1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

2. 开通能力:

重要

本能力支持企业或个人认证用户开通。更多实名认证操作信息,请参见实名认证

3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权

4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。

5. 开发接入步骤:

  • SDK总览中选择您要接入使用的SDK语言。
  • 在对应语言的SDK文档中找到AI类目为人脸人体(facebody)的SDK包进行安装。
  • 参考文档中提供的示例代码进行适当修改后调用。

6. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

计费说明

人脸核身App认证只计费发起核身认证请求接口(GenRealPersonVerificationToken)的费用,查询结果接口(GetRealPersonVerificationResult)不计费。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String GetRealPersonVerificationResult

系统规定参数。取值:GetRealPersonVerificationResult

VerificationToken String cwek23dw24geor89230hf2rw

可信核身认证的唯一标识。

说明 已认证通过的VerificationToken不能做二次查询校验,否则会报错。

返回数据

名称

类型

示例值

描述

RequestId String 10FC953D-7C0C-4915-8949-34E3246E5B79

请求ID。

Data Object

返回的结果数据内容。

Passed Boolean true

认证是否通过。

  • true:通过。
  • false:不通过。

SDK参考

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

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=GetRealPersonVerificationResult      //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&VerificationToken=cwek23dw24geor89230hf2rw
&公共请求参数

正常返回示例

XML格式

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

<GetRealPersonVerificationResultResponse>
    <RequestId>10FC953D-7C0C-4915-8949-34E3246E5B79</RequestId>
    <Data>
        <Passed>true</Passed>
    </Data>
</GetRealPersonVerificationResultResponse>

JSON格式

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

{
  "RequestId" : "10FC953D-7C0C-4915-8949-34E3246E5B79",
  "Data" : {
    "Passed" : true
  }
}

错误码

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

状态码

错误码

描述

200

无错误码

刷脸认证通过。

400

INVALID_PARAMETER

查询时传入参数不正确。联系接口提供方技术人员排查。例如身份证格式不正确。(Z8105)

400

NOT_SAME_PERSON

刷脸认证未通过,识别结果为非本人,请确认是否为本人再发起认证。抱歉,没有认出您。(Z1146)

500

PROCESSING

刷脸认证未完成。请重试,如果一直不成功,联系接口提供方技术人员排查。

500

PROCESSING

图片安全检测不通过,请确认图片是否为正常拍摄图片。(Z1146)

500

PROCESSING

系统出错了,请您稍后再试,如果多次重试依然报错,请记录好RequestId联系阿里云技术支持工程师。(Z5137)

500

INVALID_PARAM

抱歉,系统出错了,请您稍后再试 ,如果多次重试依然报错,请记录好RequestId联系阿里云技术支持工程师。(Z5132)

400

UNABLE_GET_IMAGE

比对源不可用。远程公安网没有留底图片,无法比对。请记录好RequestId联系阿里云技术支持工程师。(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联系阿里云技术支持工程师。(Z5139)

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
  • 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。