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

功能描述

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

前提条件

请确保您已开通人脸人体服务,若未开通服务请立即开通

调试

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

请求参数

名称 类型 是否必选 示例值 描述
VerificationToken String cwek23dw24geor89230hf2rw

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

MaterialHash String dafew02dsfe

认证材料(人脸图像,如移动端采集认证后获得的人脸图像)的哈希。

返回数据

名称 类型 示例值 描述
RequestId String 10FC953D-7C0C-4915-8949-34E3246E5B79

请求ID。

Data object

返回的结果数据内容。

Pass Boolean true

认证是否通过。

  • true:通过。
  • false:不通过。
IdentityInfo String T

认证材料哈希是否匹配。

  • 如果有材料哈希参数传入,匹配则返回值为T,不匹配则返回值为F
  • 如果无材料哈希参数传入,则返回空字符串。
MaterialMatch 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识别的信息可能不一致。

示例

请求示例

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

正常返回示例

XML格式

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

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

JSON格式

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

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