身份证实名认证接口

时间：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

相关文章