金润·核验通-企业四要素核验接口文档

简介: 企业四要素核验接口介绍:企业名称、企业标识、姓名、身份证号四要素核验更新时间:实时接口类型:API接口数据优势:直连官方数据信息,合法合规、权威、精确数据安全:仅确认是否一致,保护个人信息隐私计费方式:核验计费,详情请咨询

金润·核验通-企业四要素核验接口文档

企业四要素接口行业内常用语

 【企业四要素】【四要素】【全国企业核验查询】【全国企业公司信息核验】【企业信息核验】【企业四要素验证】【企业四要素校验】【企业四要素数据】【企业四要素认证接口】【企业四要素认证】【企业四要素接口】【企业四要素核验】【企业四要素查询】【企业核验】【企业工商信息核验】【企业工商四要素验证】【企业工商四要素校验】【企业工商四要素核证】【企业工商四要素核验】【企业工商四要素核查】【企业工商四要素查询】【企业工商四要素】【公司四要素核验】【工商四要素】【公司信息查询】【公司四要素】【公司信息核验】【公司四要素验证】【公司四要素校验】【公司四要素数据】【公司四要素认证接口】【公司四要素认证】【公司四要素接口】【公司四要素查询】【公司核验】【公司工商信息核验】【公司工商四要素验证】【公司工商四要素校验】【公司工商四要素核证】【公司工商四要素核验】【公司工商四要素核查】【公司工商四要素查询】【公司工商四要素】

 目录


1. 接口描述

2. 加密方式

2.1 加签,验签机制说明

2.2 签名算法

2.3 加密方式

2.4 生成签名

2.4.1 筛选并排序

2.4.2 拼接

2.4.3 调用签名函数

2.4.4 拼接完整请求

2.5 解密方式

3. 请求参数

3.1 公共请求参数

3.2 接口请求参数

4. 响应参数

4.1 公共响应参数

4.2 接口响应参数

5. 代码示例

5.1 请求示例

5.2 响应示例

5.3 异常示例

6. 附录

6.1 接口返回码


1. 企业四要素核验接口接口描述

接口名称

企业四要素

接口编号

JR-HYT-014

接口描述

验证企业名称、工商注册号、法人姓名、法人身份证号码与工商登录信息是否一致

接口地址

/dmp/api

请求方式

POST

加密方式

RSA2


2. 企业四要素核验接口加密方式

2.1 加签,验签机制说明

客户在应用中使用自己的“私钥”对消息加签之后,消息和签名会传递给金枢系统,金枢系统则使用应用的 公钥 验证消息的真实性(来自于合法应用的真实消息)。

对于金枢系统返回消息给商户应用的情形,应用则使用金枢系统的 公钥 来验证返回消息的真实性。

 

2.2 签名算法

签名算法:RSA2

标准签名算法:SHA256WithRSA

描述:强制要求 RSA 密钥的长度至少为 2048。

 

2.3 加密方式

请求体加密

将请求参数(biz_content)字段通过 私钥进行加密

2.4 生成签名

2.4.1 筛选并排序

获取所有请求参数(包括公共请求参数),不包括字节类型参数,如文件、字节流,剔除 sign 字段,剔除值为空的参数,并按照第一个字符的键值 ASCII 码递增排序(字母升序排序),如果遇到相同字符则按照第二个字符的键值 ASCII 码递增排序,以此类推。

2.4.2 拼接

将排序后的参数与其对应值,组合成 参数=参数值 的格式,并且把这些参数用 & 字符连接起来,此时生成的字符串为待签名字符串。

示例:

app_id=2014072300XXXXXX&biz_content=fV9IJsNcmZcPEQbvr8S3kkJ3uT0GRfHlAM25LT8w9xCAJqywxotrVlH1ZJsIXwHBvz97uFyNbBoSKbxfRgwKLl7P88hKBmPDwyDzB4t8MT&charset=UTF-8&method=alipay.trade.pay&sign_type=RSA2×tamp=2014-07-24 03:07:50&version=1.0

2.4.3 调用签名函数

使用各自语言对应的 SHA256WithRSA(对应 sign_type 为 RSA2)签名函数利用商户私钥对签名字符串进行签名,并进行 Base64 编码。把生成的签名 encode 后赋值给 sign 参数,拼接到请求参数中。

2.4.4 拼接完整请求

调用签名函数 后需将生成的签名作为 sign 的 value 拼接到请求数据中。

示例:

app_id=2014072300XXXXXX&biz_content=fV9IJsNcmZcPEQbvr8S3kkJ3uT0GRfHlAM25LT8w9xCAJqywxotrVlH1ZJsIXwHBvz97uFyNbBoSKbxfRgwKLl7P88hKBmPDwyDzB4t8MT&charset=UTF-8&method=alipay.trade.pay&sign_type=RSA2×tamp=2014-07-24 03:07:50&version=1.0&sign=GhT5Q6YxBtvf4q855TiNWEF/DIeLMyEE97+OnJDHpe6joNfr9F3BAE37dczcogU7uLfpNo+dh3cgly05bQN5nTj9TJ3SrBZWa40cltlgkI+6+0FuJoFSA225+MCrD4fNNqi2Zd5Adi9qC9NdN8nBVsjvzqtn5NepOt8dG1qdv7KvVwG74emFea1j2JuMBVBMp2PgIEwCv5c8OJSXa2P66+l3YCqEEMjBN22Dz0chlJ4hKMW3rA2oISH6ryzIvNIiy4/djKEdmxFeBorp1vrbmAtBqE++afggzzGt5w4arkbQ4fWLXJwkC9+1y4irCgmX65CEb5ct+fRgG2/9/B0rYg==

 

2.5 解密方式

返回数据data内容是加密的,要用商户的公钥解密。


3. 企业四要素核验接口请求参数

参数

类型

必填

最大长度

说明

app_id

String

Y

32

金润商务提供

method

String

Y

100

固定值:

"jinrun.company.company.elements4"

sign

String

Y

 

参见2加密方式

charset

String

Y

10

utf-8

format

String

Y

10

json

sign_type

String

Y

10

RSA2

version

String

Y

10

1.0

3.1 公共请求参数

 

3.2 接口请求参数

参数

类型

必填

最大长度

说明

biz_content

name

String

Y

30

企业法人姓名

regno

String

Y

100

企业工商注册号/统一信用代码

idcard

String

Y

50

企业法人身份证号

entname

String

N

10

企业名称 名称、信用代码二选一

4. 企业四要素核验接口响应参数

4.1 公共响应参数

参数

类型

说明

code

String

响应码见附录6.1

request_id

String

请求Id

message

String

响应信息

timestamp

Long

时间戳

data

String

返回数据

 

4.2 接口响应参数

参数

类型

说明

resultMsg

String

查询结果描述

result

String

状态码

entNameMatch

Int

企业名称是否匹配1.匹配 0.不匹配

idNoMatch

Int

身份证号码是否匹配1.匹配 0.不匹配

realnameMatch

Int

姓名是否匹配1.匹配 0.不匹配

regNoMatch

Int

工商注册号是否匹配 1匹配 0不匹配

5. 企业四要素核验接口代码示例

5.1 请求示例

biz_content的json格式样例

{

    "regno": "",

    "name": "",

    "entname": "",

    "idcard": ""

}

 

5.2 响应示例

{

    "request_id": "SN1527126563487879168",

    "code": "1",

    "data": {

       "data": {

           "result": 1,

           "resultMsg": "查询成功",

           "entNameMatch": 1,

           "idNoMatch": 0,

           "realnameMatch": 1,

           "regNoMatch": 1

       },

       "seqNum": "7320021300199588",

       "message": "成功",

       "status": 0

},

    "message": "查询成功",

    "timestamp": 1652930320857

}

 

5.3 异常示例

{

"request_id": "SN1527163857943007232",

    "code": "400",

    "message": "",

    "timestamp": 1652939212046

}

 

6. 企业四要素核验接口附录

6.1 接口返回码

编码

描述

是否收费

1

查询成功,有数据

收费

2

查询成功,无数据

免费

400

错误信息

免费

 

系统错误

免费

 

参数错误

免费

 

数据异常,未能获取结

免费

 

用户不存在或者配置错误

免费

 

TokenKey验证失败

免费

 

接口未定义或停止使用

免费

 

用户没有接口使用权限

免费

 

用户接口暂停使用

免费

 

用户余额不足

免费

 

系统繁忙,请稍候再试

免费

 

参数异常,企业名称、注册号二选⼀。

免费


相关文章
|
安全 API 数据安全/隐私保护
企业四要素核验接口
在企业管理中,为了提高企业的管理效率和效果,减少人工处理的工作量,企业常常会应用各种信息化技术来辅助管理,其中企业四要素核验接口便是其中的一种。
|
存储 分布式计算 DataWorks
DataWorks报错问题之报错0420095如何解决
DataWorks是阿里云提供的一站式大数据开发与管理平台,支持数据集成、数据开发、数据治理等功能;在本汇总中,我们梳理了DataWorks产品在使用过程中经常遇到的问题及解答,以助用户在数据处理和分析工作中提高效率,降低难度。
|
缓存 运维 数据库
【测试人员兼职指南】利用专业技能:如何从测试转向开发赚钱
本文分享了作者作为测试人员如何利用专业技能转向开发来兼职赚钱的经验,包括分析和解决登录页面跳转、避免重复账号注册、用户登录后首页显示用户名以及添加退出功能等问题,并提供了Django项目中使用sqlite3数据库和后台管理的扩展技巧。
372 1
【测试人员兼职指南】利用专业技能:如何从测试转向开发赚钱
|
7月前
|
移动开发 安全 虚拟化
VMware ESXi 8.0U3c - 领先的裸机 Hypervisor
VMware ESXi 8.0U3c - 领先的裸机 Hypervisor
177 0
VMware ESXi 8.0U3c - 领先的裸机 Hypervisor
|
存储 Kubernetes 容器
Kubernetes 存储选项:持久化卷与存储类
【8月更文第29天】随着容器化的普及,越来越多的应用程序需要持久化数据以保持状态信息。Kubernetes 提供了一套完整的解决方案来管理和配置持久化存储,包括持久卷 (Persistent Volume, PV)、持久卷声明 (Persistent Volume Claim, PVC) 和存储类 (StorageClass)。本文将详细介绍这些概念,并通过实际示例来演示如何在 Kubernetes 中配置存储。
800 2
|
8月前
|
前端开发 安全 开发工具
CMS系统是什么?CMS用来做什么的?
CMS是网站开发工具,包括前端模版和后端后台。支持私有化部署,包含页面管理、会员管理、标签管理等。用户无需建站基础和专业知识,即可快速建设和管理网站。大型企业网站、新闻网站等多采用CMS。
399 8
|
11月前
|
NoSQL 测试技术 Redis
第一次面试总结 - 迈瑞医疗 - 软件测试
本文是作者对迈瑞医疗软件测试岗位的第一次面试总结,面试结果非常好,但面试过程中没有提问太多技术性问题,主要围绕个人介绍、互相了解、个人规划和项目亮点进行,因此作者认为这次面经的学习意义不大。作者还提到了实习岗位的待遇和工作内容,以及对不同阶段求职者的建议。
273 2
|
数据采集 存储 监控
99%成功率背后:阿里云短信服务有何优势?
为什么短信会发送失败,如何提高短信发送成功率,本文将为您介绍短信发送成功率和阿里云短信服务如何保障企业短信稳定送达等相关知识。
536 1
99%成功率背后:阿里云短信服务有何优势?
|
11月前
|
运维 jenkins 持续交付
自动化部署的魅力:如何用Jenkins和Docker简化运维工作
【10月更文挑战第7天】在现代软件开发周期中,快速且高效的部署是至关重要的。本文将引导你理解如何使用Jenkins和Docker实现自动化部署,从而简化运维流程。我们将从基础概念开始,逐步深入到实战操作,让你轻松掌握这一强大的工具组合。通过这篇文章,你将学会如何利用这些工具来提升你的工作效率,并减少人为错误的可能性。
|
10月前
|
Java Spring
JAVA获取重定向地址URL的两种方法
【10月更文挑战第17天】本文介绍了两种在Java中获取HTTP响应头中的Location字段的方法:一种是使用HttpURLConnection,另一种是使用Spring的RestTemplate。通过设置连接超时和禁用自动重定向,确保请求按预期执行。此外,还提供了一个自定义的`NoRedirectSimpleClientHttpRequestFactory`类,用于禁用RestTemplate的自动重定向功能。
549 0