身份证实名认证接口

使用本接口可快速查询身份证号码与姓名是否一致,经连接官方身份证中心联网核查后输出结果,结果分为三种:一致、不一致、无此身份证号码。 查看详细介绍>>

  • 简版
  • 加密版
  • 下载文档 下载文档

1.1、接口说明

接口地址:https://api.id98.cn/api/idcard

请求方式:get/post

返回格式:json

编码类型:utf-8

1.2、参数列表

参数名 是否必填 参数说明
appkey 我司分配给您的appkey
name 被查询者姓名
cardno 被查询者18位身份证号码

1.3、请求示例

1.4、返回参数(json)

示例:

{
"isok":1,
"code":1,
"data":
{"err":0,
"address":"\u5c71\u4e1c\u7701\u6cf0\u5b89\u5e02\u5cb1\u5cb3\u533a",
"sex":"M",
"birthday":"1986-02-12"}
}

各参数含义如下:

字段 说明
isok 是否查询成功
0:查询失败 , 1:查询成功
code 查询结果,详细code含义见下方表格
data 身份证包含信息
err 是否符合身份证号码格式
0:符合 , -1:不符合
address unicode格式身份证所在地 (err:-1时无此结果)
sex 性别(err:-1时无此结果)
M:男性 , F:女性
birthday 生日信息(err:-1时无此结果)

isok:1 查询成功,结果如下

code 说明
1 一致
2 不一致
3 无此身份证号码

isok:0 查询失败(不扣费),原因如下

code 说明
11 参数不正确
12 商户余额不足
13 appkey不存在
14 IP被拒绝
20 身份证中心维护中
21 同一信息调用次数过多,请稍后再试

常见问题:isok、code、err 三个参数有什么区别?

isok代表此次查询是否成功,并不是查询结果,isok=1代表查询成功,返回一致、不一致、无此号码三种结果之一,isok=0代表查询失败,返回失败的原因。

code代表查询结果,包括一致、不一致、无此号码的结果,或者查询失败的原因。

err代表此身份证号码是否符合标准身份证号码编码格式,此参数只与身份证号码有关,与结果是否一致无关。

少数民族姓名中的点号 · 要如何输入?

方法一:点号 · 原样输入即可,为了避免不同编码类型的差异,请确保该点号的URL编码为 %C2%B7

方法二:可用符号 * 代替该点号,系统可自动识别并替换为点号

1.1、接口说明

接口地址:https://v.id98.cn/apis/auth/idcard

请求方式:post

返回格式:json

编码类型:utf-8

加密方式:RSA加密

1.2、参数列表

参数名称 是否必填 类型 参数说明
userid string 用户ID
data string 查询数据加密串

data查询数据参数如下(json格式):

参数名 是否必填 类型 参数说明
appkey string 唯一标识
name string 被查询者姓名
cardno string 被查询者18位身份证号码

1.3、请求示例

第一步:待核查的原始数据内容如下(json格式):

{
"appkey":"c4ca4238a0b923820dcc509a6f75849b",
"name":"邓永望",
"cardno":"610922197401232578",
}

第二步:对以上数据使用悦园公钥进行RSA加密:

jrHPYINNuPlVMOf3eD3mQ3Br0CcWo7vHP3qcf/wyo77eQKXuWf6YWsb4BQNlEolelUC4c5UTj3+SLzSxS2xM6FvjceuIhHg6GQ7++bjj+Ly1Fqsqb4VFQ
wNx2XQVI3hcmRiKE+UmPmo7G83/3/0T8ZmQHdYogQkY7y8i+MlNooU=f1uqsTbhe6riDSXNU6bhup1BHDCbjslMwzvKJgl9+H8uB7+bm/+rG2n/KWa3w
oa2ejcbhSfzAr5AcYh4z8zCLu9pza7iGYPlzAl6xR3VOo/dWVAEc4kb7dkJYki21MBKqiiWZPRGSyyo5MmBIMjVlMV/Hg6FNjRzOcpB55wWDkw=

第三步:把以上加密后的结果赋值给data参数,并加上userid转为JSON格式如下:

{
"userid":"edf51739e3d54f8e",
"data":"jrHPYINNuPlVMOf3eD3mQ3Br0CcWo7vHP3qcf/wyo77eQKXuWf6YWsb4BQNlEolelUC4c5UTj3+SLzSxS2xM6FvjceuIhHg6GQ7++bjj+Ly1Fqsq
b4VFQwNx2XQVI3hcmRiKE+UmPmo7G83/3/0T8ZmQHdYogQkY7y8i+MlNooU=f1uqsTbhe6riDSXNU6bhup1BHDCbjslMwzvKJgl9+H8uB7+bm/+rG2n/
KWa3woa2ejcbhSfzAr5AcYh4z8zCLu9pza7iGYPlzAl6xR3VOo/dWVAEc4kb7dkJYki21MBKqiiWZPRGSyyo5MmBIMjVlMV/Hg6FNjRzOcpB55wWDkw="
}

第四步:把以上数据post提交到我司服务器即可。

1.4、返回示例

{
"state":1,
"content":"NtA5WL7N\/1ePFkGPiwHulahvmmWujyTcwHLvuUsqsnoKMi\/2AkIw\/QXVdN+amskNddnTrfbXDJmpOQczta1LpLejcLSwRuwEH9GVFDLH6IV
VMeCT59Tt9vGVQXw7YpB81L7QMbwZUyM9L+KpAZYRfAm5A5WeJgbZmGFLS+Ejlgo="
}

以上结果中content内容使用商户私钥进行解密,解密后结果如下:

{
"isok":1,
"code":1,
"data":
{"err":0,
"address":"\u5c71\u4e1c\u7701\u6cf0\u5b89\u5e02\u5cb1\u5cb3\u533a",
"sex":"M",
"birthday":"1986-02-12"}
}

各参数含义如下:

参数名称 类型 说明
state int 执行结果
content string 核查结果加密串

state字段含义:

state 说明
0 请求数据为空
1 请求成功
2 userid错误或不存在
3 解密失败
6 appkey与userid匹配失败

对content参数解密后核查结果如下:

字段 说明
isok 是否查询成功
0:查询失败 , 1:查询成功
code 查询结果,详细code含义见下方表格
data 身份证包含信息
err 是否符合身份证号码格式
0:符合 , -1:不符合
address unicode格式身份证所在地 (err:-1时无此结果)
sex 性别(err:-1时无此结果)
M:男性 , F:女性
birthday 生日信息(err:-1时无此结果)

isok:1 查询成功,结果如下

code 说明
1 一致
2 不一致
3 无此身份证号码

isok:0 查询失败(不扣费),原因如下

code 说明
11 参数不正确
12 商户余额不足
13 appkey不存在
14 IP被拒绝
20 身份证中心维护中
21 同一信息调用次数过多,请稍后再试

400-107-1001

权威认证

Certification国际认证
信息安全管理体系认证

重庆悦园科技有限公司

重庆市渝北区东湖南路40号力帆时代2栋
在线咨询
QQ咨询
400-107-1001 电话咨询
扫一扫
扫一扫添加客服微信