本文介绍核身认证移动端查询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"
  }
}