身份证实名认证接口 实名认证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

版权说明

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

点这里可以跳转到人工智能网站