SAAS云部署
PAAS私有化部署
文档中心
工商企业四要素API
1. 接口描述
提供企业名称 + 企业资质编号类型 + 企业资质编号内容 + 企业法定代表人姓名 + 企业法定代表人证件编号的四要素核验接口
2. 使用场景
通过企业名称 + 企业资质编号类型 + 企业资质编号内容 + 企业法定代表人姓名 + 企业法定代表人证件编号验证企业名称匹配情况、企业资质编号匹配情况、企业法定代表人姓名匹配情况、企业法定代表人证件编号匹配情况。
3. 接口说明
3.1 企业四要素
3.1.1. 接口协议
HTTP POST
3.1.2. 接口方法
https://api.juncyun.com/api/identityVerify/ent4elements
3.1.3. 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
application/json |
|
|
2） |
Content-Type |
application/json;charset=utf-8 |
|
3.1.4.1. 请求参数列表
|
编码 |
列表 |
参数类型 |
内容 |
备注 |
|
1） |
accessKey |
String |
API调用账号 |
必填，String类型 |
|
2） |
accessSecret |
String |
API调用密钥 |
必填，String类型 |
|
3） |
entName |
String |
企业名称 |
长度在100个字符以内 |
|
4） |
entQualificationType |
String |
企业资质编号类型 |
1: 企业营业执照统一社会信用代码 3: 个体工商户营业执照统一社会信用代码 4: 个体工商户营业执照注册号 |
|
5） |
entQualificationNum |
String |
企业资质编号内容 |
个体工商户营业执照注册号15位，其他编号类型要求18位 |
|
6） |
corporateName |
String |
企业法定代表人姓名 |
长度限制在100个字符以内 不支持数字和特殊字符长度限制在100个字符以内 |
|
7） |
corporateIdCard |
String |
企业法定代表人身份证号 |
长度限制在18位字符 |
3.1.4.2. 请求参数示例
{
"accessKey":"87d0373b**********",
"accessSecret":"b20d7c5e1c********************",
"entName": "******",
"entQualificationType": 1,
"entQualificationNum": "******************",
"corporateName": "***",
"corporateIdCard": "******************"
}
3.1.5. 响应参数
3.1.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
code |
状态码 |
200成功、500失败 |
|
2） |
msg |
认证结果描述 |
|
|
3） |
success |
处理是否成功: |
取值范围 true、false |
|
4） |
data |
业务数据 如果失败则为空 |
|
|
5） |
orderId |
业务唯一流水号 |
|
|
6） |
entNameMatch |
企业名称匹配情况 |
true 成功、false失败 |
|
7） |
entQualificationNumMatch |
企业资质编号匹配情况 |
true 成功、false失败 |
|
8） |
fee |
是否收费：0 不收费，1 收费 |
|
|
9） |
reqNo |
请求唯一标识 |
|
|
10） |
remark |
status 结果码描述说明 |
|
|
11） |
corporateIdCardMatch |
企业法人代表证件身份证号匹配情况 |
true 成功、false失败 |
|
12） |
status |
返回结果码 01：一致 02：不一致 03：不确定（库无） 04：通道调用异常，原因可能是：输入参数有误，通道异常等，具体可参考 remark 字段（注：result=01，02 计费，其它不计费） |
|
|
13） |
corporateNameMatch |
企业法人代表姓名匹配情况 |
true 成功、false失败 |
3.1.5.2. 响应参数示例
3.1.5.2.1. 成功示例
{
"code": 200,
"msg": "成功",
"success": true,
"data": {
"orderId": "021725***********",
"entNameMatch": true,
"entQualificationMatch": true,
"fee": 1,
"reqNo": "AI17255***********",
"remark": "一致",
"corporateIdCardMatch": true,
"status": 1,
"corporateNameMatch": true
}
}
3.1.5.2.2. 失败示例
{
"code": 400,
"msg": "校验异常：统一社会信用代码格式不正确",
"success": false,
"data": {
"fee": 0,
"reqNo": "AI1725516403967497061238"
}
}
工商企业四要素API
1. 接口描述
提供企业名称 + 企业资质编号类型 + 企业资质编号内容 + 企业法定代表人姓名 + 企业法定代表人证件编号的四要素核验接口
2. 使用场景
通过企业名称 + 企业资质编号类型 + 企业资质编号内容 + 企业法定代表人姓名 + 企业法定代表人证件编号验证企业名称匹配情况、企业资质编号匹配情况、企业法定代表人姓名匹配情况、企业法定代表人证件编号匹配情况。
3. 接口说明
3.1 企业四要素
3.1.1. 接口协议
HTTP POST
3.1.2. 接口方法
https://api.juncyun.com/api/identityVerify/ent4elements
3.1.3. 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
application/json |
|
|
2） |
Content-Type |
application/json;charset=utf-8 |
|
3.1.4.1. 请求参数列表
|
编码 |
列表 |
参数类型 |
内容 |
备注 |
|
1） |
accessKey |
String |
API调用账号 |
必填，String类型 |
|
2） |
accessSecret |
String |
API调用密钥 |
必填，String类型 |
|
3） |
entName |
String |
企业名称 |
长度在100个字符以内 |
|
4） |
entQualificationType |
String |
企业资质编号类型 |
1: 企业营业执照统一社会信用代码 3: 个体工商户营业执照统一社会信用代码 4: 个体工商户营业执照注册号 |
|
5） |
entQualificationNum |
String |
企业资质编号内容 |
个体工商户营业执照注册号15位，其他编号类型要求18位 |
|
6） |
corporateName |
String |
企业法定代表人姓名 |
长度限制在100个字符以内 不支持数字和特殊字符长度限制在100个字符以内 |
|
7） |
corporateIdCard |
String |
企业法定代表人身份证号 |
长度限制在18位字符 |
3.1.4.2. 请求参数示例
{
"accessKey":"87d0373b**********",
"accessSecret":"b20d7c5e1c********************",
"entName": "******",
"entQualificationType": 1,
"entQualificationNum": "******************",
"corporateName": "***",
"corporateIdCard": "******************"
}
3.1.5. 响应参数
3.1.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
code |
状态码 |
200成功、500失败 |
|
2） |
msg |
认证结果描述 |
|
|
3） |
success |
处理是否成功: |
取值范围 true、false |
|
4） |
data |
业务数据 如果失败则为空 |
|
|
5） |
orderId |
业务唯一流水号 |
|
|
6） |
entNameMatch |
企业名称匹配情况 |
true 成功、false失败 |
|
7） |
entQualificationNumMatch |
企业资质编号匹配情况 |
true 成功、false失败 |
|
8） |
fee |
是否收费：0 不收费，1 收费 |
|
|
9） |
reqNo |
请求唯一标识 |
|
|
10） |
remark |
status 结果码描述说明 |
|
|
11） |
corporateIdCardMatch |
企业法人代表证件身份证号匹配情况 |
true 成功、false失败 |
|
12） |
status |
返回结果码 01：一致 02：不一致 03：不确定（库无） 04：通道调用异常，原因可能是：输入参数有误，通道异常等，具体可参考 remark 字段（注：result=01，02 计费，其它不计费） |
|
|
13） |
corporateNameMatch |
企业法人代表姓名匹配情况 |
true 成功、false失败 |
3.1.5.2. 响应参数示例
3.1.5.2.1. 成功示例
{
"code": 200,
"msg": "成功",
"success": true,
"data": {
"orderId": "021725***********",
"entNameMatch": true,
"entQualificationMatch": true,
"fee": 1,
"reqNo": "AI17255***********",
"remark": "一致",
"corporateIdCardMatch": true,
"status": 1,
"corporateNameMatch": true
}
}
3.1.5.2.2. 失败示例
{
"code": 400,
"msg": "校验异常：统一社会信用代码格式不正确",
"success": false,
"data": {
"fee": 0,
"reqNo": "AI1725516403967497061238"
}
}
一对一服务，更有优惠惊喜
公众号
Copyright © 浙江卓见云科技有限公司 All Rights Reserved 浙ICP备16013515号-16