身份證實名認證接口

   使用本接口可快速查詢身份證號碼與姓名是否一致，經連接官方身份證中心聯網核查后輸出結果，結果分為三種：一致、不一致、無此身份證號碼。查看詳細介紹>>

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