身份证实名认证接口

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

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