文档
测试

身份信息核验

POST
http://host:port/rest/faceid/idcardverification

接口描述

传入姓名和身份证号,校验两者的真实性和一致性。 默认接口请求频率限制:20次/秒。

Header

参数名
类型
描述
必填
Authorization
string
通过API Key和Secret Key获取的access_token,参考“Access Token获取”(本地版不需传输)
必填
Content-Type
string
application/json
必填

请求参数

参数名
类型
描述
必填
id_card
string
身份证号
必填
name
string
姓名(注:需要是UTF-8编码的中文)
必填
comcode
string
保险公司内部机构、部门代码,为后续提供数据分析服务所用
可选

响应参数

参数名
类型
描述
必填
result
string
认证结果码:0: 姓名和身份证号一致 -1: 姓名和身份证号不一致
必填
description
string
业务结果描述。
必填

说明 / 示例

###### token的使用方法(本地版不需传输) >d 在之后的接口请求中,都应该在头部带上Authorization参数,参数值以Bearer加空格开头,后接{{token}} 例如:Bearer 8d1630b2-7920-4ccd-bf37-e3309f9fdd4f 获取access_token,参考[“Access Token获取”](doc:6hjVner7) 签名算法,请查看文档:[签名算法](doc:MHaXIJs8) ### 响应说明 中科软开放平台所有API采用通用响应体包含业务响应信息构建而成。 - **通用响应体内通用参数说明:** -- **requestid**:唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 requestid -- **code**:平台响应码,0-成功,其他见响应码表 -- **message**:响应描述,大写SUCCESS表示成功,错误信息描述展示于此 -- **data**:业务响应内容体,以json格式为主,如faceid返回结构含result、description字段 -- **timestamp**:时间戳 -- **extra**:扩展信息 ###### 返回示例: ``` { "requestid": "f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a", "code": 0, "message": "success", "data": { "result": "0", "description": "姓名和身份证号一致" }, "timestamp": 1598165170322, "extra": {} } ``` ###### 返回示例,不一致情况: ``` { "code": 0, "message": "success", "data": { "result": "-1", "description": "姓名和身份证号不一致" }, "timestamp": 1598165170322, "extra": {} } ```