文章目录 全国身份证实名认证API接口目录接口基本信息1) 接口简介2) 申请地址3) 返回格式4) 请求方式5) 编码格式6) 通讯协议7) API 域名 签名方式1) 普通签名2) MD5签名验证3) AES128加密 身份证实名认证v3 接口1) 请求地址2) 示例URL3) 请求参数4) 选填参数5) 返回参数6) 返回JSON结果示例: 附件一 接口示范下载附件二 接口状态码服务状态码公共状态码,每个接口都会有计费状态码说明 附件三 定义、专业术语及缩略语其他备注版权说明
接口基本信息 1) 接口简介
文档生成时间: 2017-10-15 23:59:38
【企业专用】身份证实名认证,根据身份证姓名和身份证号码核对是否一致,实时联网公安核查,零存储,准确率100% !
请与客服联系
3) 返回格式JSON/XML
4) 请求方式POST/GET
5) 编码格式UTF-8
6) 通讯协议平台向外开放的通信协议采用http(s)协议.
7) API 域名v.****.cn (请不用在服务器上对此域名设置hosts绑定。如存在此类情况,建议删除 hosts 绑定,否则可能导致交易无法请求。)
签名方式如果您选择普通签名验证,可以忽略本章节;
支持三种签名验证方式,您可以根据自己的需求选择;
如果需要更改签名方式,需要在安全设置页面更改设置;
https://v.****.cn/api/a1
2) 示例URLhttps://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": "xsdfg", "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 在 在会员中心->我的数据页面
接口文档地址 https://www..cn/data/1
API 接口调试工具 https://www..cn/user/my/apitest/id/1
此文档的版权归科技有限公司所有,作为本系统的最终用户.可拥有该份文档的使用权.但未征得科技有限公司的书面批准,不得修改改、公布本文档,不得向第三方借阅、出让文档。