身份证实名认证接口

时间:2024-03-10 14:06:06

   使用本接口可快速查询身份证号码与姓名是否一致,经连接官方身份证中心联网核查后输出结果,结果分为三种:一致、不一致、无此身份证号码。查看详细介绍>>
 
1.1、接口说明
接口地址:http://api.id98.cn/api/idcard
请求方式:get/post
返回格式:json/xml
编码类型:utf-8 
 
1.2、参数列表
参数名 是否必填 参数说明
appkey 我司分配给您的appkey
name 被查询者姓名
cardno 被查询者18位身份证号码
output 输出格式:json/xml,默认json
 
 
1.3、请求示例
http://api.id98.cn/api/idcard?appkey=d10a8e06284cf889deaf93ffb5d9c60a&
name=邓永望&cardno=610922197401232578
 
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 身份证中心维护中
 
 
常见问题:isok、code、err 三个参数有什么区别?
isok代表此次查询是否成功,并不是查询结果,isok=1代表查询成功,返回一致、不一致、无此号码三种结果之一,isok=0代表查询失败,返回失败的原因。

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

err代表此身份证号码是否符合标准身份证号码编码格式,此参数只与身份证号码有关,与结果是否一致无关。
 
少数民族姓名中的点号 · 要如何输入?
方法一:点号 · 原样输入即可,为了避免不同编码类型的差异,请确保该点号的URL编码为 %C2%B7
方法二:可用符号 * 代替该点号,系统可自动识别并替换为点号

 

 

参考地址:http://www.id98.cn/doc/idcard