身份证实名认证接口,实名认证API接口文档

全国身份证实名认证API接口

目录

接口基本信息

1) 接口简介

文档生成时间: 2017-10-15 23:59:38
【企业专用】身份证实名认证,根据身份证姓名和身份证号码核对是否一致,实时联网公安核查,零存储,准确率100% !

2) 申请地址

请与客服联系

3) 返回格式

JSON/XML

4) 请求方式

POST/GET

5) 编码格式

UTF-8

6) 通讯协议

平台向外开放的通信协议采用http(s)协议.

7) API 域名

v.****.cn (请不用在服务器上对此域名设置hosts绑定。如存在此类情况,建议删除 hosts 绑定,否则可能导致交易无法请求。)

签名方式

如果您选择普通签名验证,可以忽略本章节;
支持三种签名验证方式,您可以根据自己的需求选择;
如果需要更改签名方式,需要在安全设置页面更改设置;

1) 普通签名

  • 请求参数中添加key参数,内容为您的appkey

2) MD5签名验证

  • 1)在安全设置页面获取固定的 appid;
  • 2)对所有要传递的字符串进行字典(a-z)排序,需排除sign字段;
  • 3)拼接字符串 将 appkey 作为后缀,进行md5计算,得到签名;
  • 4)将计算出的结果通过sign参数传递;
sign 参数示范计算方式 
md5(urlencode(appid=xxxx&&cardNo=5110111&realName=张三&information=).您的appkey)
请求示范参数
appid=xxxx&&cardNo=5110111&realName=张三&information=&sign=您计算出来的sign

3) AES128加密

  • 1)在安全设置页面获取固定的appid;
  • 2)将所有请求参数转成JSON格式;
  • 3)将JSON使用AES128加密,并对加密结果进行BASE64编码;
  • 4)请求接口地址,获取结果;
  • 5)将结果进行BASE64解码;
  • 6)进行AES128解密后获得结果;
请求示范参数
appid=xxxx&sign=AES128内容

身份证实名认证v3 接口

1) 请求地址

https://v.****.cn/api/a1

2) 示例URL

https://v.****.cn/api/a1?key=your_key&cardNo=5110111&realName=张三&information=

3) 请求参数

字段名称类型必填字段说明示范备注
keystringYAppKey在我的数据页面xxxxxx-
cardNostringY身份证号码5110111-
realNamestringY身份证姓名张三-
informationintY是否返回基本信息,如果需要填写1-

4) 选填参数

字段名称类型必填字段说明示范备注
trans_idstringN用户订单号,24 字符以内2017201230-
trans_datestringN用户订单时间,格式为YYmmddHHiiss20160112122233-
trans_remarkstringN用户备注,原路返回xxx-
accountstringN是否返回账户信息,如需返回剩余可用次数,请传递auto如果账户是按次数扣除,则返回剩余次数如账户是按金额扣除,则返回账户剩余金额200-
outputstringN输出格式,默认JSON;可选项JSON/XMLJSON-

5) 返回参数

字段名称类型必填字段说明备注
error_codeintY状态码-
reasonstringY状态说明-
ordersignstringY订单号-
resultstringY结果集-

6) 返回JSON结果示例:


{
  "error_code": 0,
  "reason": "认证通过", /*验证结果*/
  "result": {
    "realName": "李xxx",
    "cardNo": "4206061"
  },
  "ordersign": "2017052722072914949571005"
}

附件一 接口示范下载

名称下载地址备注
PHP 版示范https://www.****.cn/code/1_1_pdf-
JAVA 版示范https://www.****.cn/code/1_2_pdf-
C# 版示范https://www.****.cn/code/1_3_pdf-
ASP 版示范https://www.****.cn/code/1_4_pdf-
Delphi 版示范https://www.****.cn/code/1_5_pdf-
Go 版示范https://www.****.cn/code/1_6_pdf-
NodeJS 版示范https://www.****.cn/code/1_7_pdf-
VB 版示范https://www.****.cn/code/1_8_pdf-
PowerBuilder 版示范https://www.****.cn/code/1_9_pdf-
Python 版示范https://www.****.cn/code/1_10_pdf-
VBS 版示范https://www.****.cn/code/1_12_pdf-
PHP-MD5 版示范https://www.****.cn/code/1_13_pdf-
JAVA-AES128 版示范https://www.****.cn/code/1_14_pdf-
PHP-AES128 版示范https://www.****.cn/code/1_15_pdf-
CURL 版示范https://www.****.cn/code/1_16_pdf-
Swift 版示范https://www.****.cn/code/1_17_pdf-
ObjectC 版示范https://www.****.cn/code/1_18_pdf-
RUBY 版示范https://www.****.cn/code/1_19_pdf-

附件二 接口状态码

服务状态码

状态码说明是否收费备注
0认证通过收费-
80001参数不完整不收费-
80003姓名格式不正确不收费-
80004身份证号码格式不正确不收费-
80008身份证中心维护,请稍后重试不收费-
80009身份证中心链接失败,请稍后重试不收费-
90033无此身份证号码收费-
90099认证不通过收费-

公共状态码,每个接口都会有

状态码说明是否收费备注
10001缺少key或者key不正确,如需key请先申请不收费-
10002账户可用次数不足不收费-
10003您的key已经过期不收费-
10004您的key和您所调用的方法不一致不收费-
10005应用未审核超时,请提交认证不收费-
10006您设置了IP白名单,您的IP不在允许的范围内不收费-
10007您的key存在风险,已被暂停使用不收费-
10008appid不正确不收费-
10009sign参数不能为空不收费-
10010sign不正确不收费-
10011请正确设置您的接入模式不收费-
10012风险控制不收费-
20001您选择了rsa加密,但是您还未上传公钥不收费-
20002您选择了rsa加密,请将密文通过condition参数传递不收费-
20003请确认你的私钥是否正确不收费-
20004Rsa解密失败不收费-
30001您的应用未审核或应用未授权于您不收费-
30002系统内部异常不收费-
30003接口维护(接口维护会提前30天发送短信至您的手机,并提供备用通道)不收费-
30004接口停用(接口停用会提前60天发送短信至您的手机)不收费-

计费状态码说明

网站所有接口,如无特殊说明,状态码为 0 或 大于90000 小于99999 计费; 其于状态码不计费;
公共状态码状态码 10000 至 40000 (每个接口都会有)
服务状态码 0 或 50000 至 99999

附件三 定义、专业术语及缩略语

名称描述备注
key密钥由加数分配给您的唯一key,新用户统一为32位-
HTTPHTTP协议(Hypertext Transfer Protocol,超文本传输协议)是用于从WWW服务器传输超文本到本地浏览器的传送协议,是一个客户端和服务器端请求和应答的标准(TCP)。超文本传输协议是互联网上应用最为广泛的一种网络协议。所有的WWW文件都必须遵守这个标准。-
XMLXML(Extensible Markup Language)即可扩展标记语言,它与HTML一样,都是SGML(Standard Generalized Markup Language,标准通用标记语言)。Xml是Internet环境中跨平台的,依赖于内容的技术,是当前处理结构化文档信息的有力工具。扩展标记语言XML是一种简单的数据存储语言,使用一系列简单的标记描述数据,而这些标记可以用方便的方式建立,XML极其简单易于掌握和使用。-
JSONJSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。易于人阅读和编写,同时也易于机器解析和生成。它基于JavaScript(Standard ECMA-262 3rd Edition - December 1999)的一个子集; JSON采用完全独立于语言的文本格式。-
UTF-8UTF-8是UNICODE的一种变长字符编码又称万国码,由Ken Thompson于1992年创建。现在已经标准化为RFC 3629。UTF-8用1到6个字节编码UNICODE字符。用在网页上可以同一页面显示中文简体繁体及其它语言(如日文,韩文)-
MD5Message Digest Algorithm MD5(中文名为消息摘要算法第五版)为计算机安全领域广泛使用的一种散列函数,用以提供消息的完整性保护。MD5的典型应用是对一段信息(Message)产生信息摘要(Message-Digest),以防止被篡改。-
TCP传输控制协议(英语:Transmission Control Protocol, TCP)是一种面向连接的、可靠的、基于字节流的传输层通信协议,由IETF的RFC 793定义。在简化的计算机网络OSI模型中,它完成第四层传输层所指定的功能,用户数据报协议(UDP)是同一层内另一个重要的传输协议。-

其他备注

您的key 在 在会员中心->我的数据页面
接口文档地址 https://www..cn/data/1
API 接口调试工具 https://www.
.cn/user/my/apitest/id/1

版权说明

此文档的版权归科技有限公司所有,作为本系统的最终用户.可拥有该份文档的使用权.但未征得科技有限公司的书面批准,不得修改改、公布本文档,不得向第三方借阅、出让文档。

  • 7
    点赞
  • 51
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值