登录

文档中心

文档目录

工商企业四要素API

最近更新时间: 2024-01-24 15:12:07

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.3.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.3.2. 请求参数示例

{
      "accessKey":"87d0373b**********",

      "accessSecret":"b20d7c5e1c********************",
      "entName": "******",
      "entQualificationType": 1,
      "entQualificationNum": "******************",
      "corporateName": "***",
      "corporateIdCard": "******************"
}

 

3.1.4. 响应参数

3.1.4.1. 响应参数列表

编码

列表

参数类型

内容

备注

1) 

code

int

状态码

200成功、500失败

2) 

msg

String

认证结果描述

 

3) 

success

boolean

处理是否成功:

取值范围 truefalse

4) 

data

 

业务数据 如果失败则为空

 

5) 

status

int

认证状态

1 认证成功 2 认证失败

6) 

entNameMatch

boolean

企业名称匹配情况

true 成功、false失败

7) 

entQualificationNumMatch

boolean

企业资质编号匹配情况

true 成功、false失败

8) 

corporateNameMatch

boolean

企业法人代表姓名匹配情况

true 成功、false失败

9) 

corporateIdCardMatch

boolean

企业法人代表证件身份证号匹配情况

true 成功、false失败

 

3.1.4.2. 响应参数示例

3.1.4.2.1. 成功示例

{
    "code": 200,
    "msg": "操作成功",
    "success": true,
    "data": {
        "status": 1,
        "entNameMatch": true,
        "entQualificationNumMatch": true,
        "corporateNameMatch": true,
        "corporateIdCardMatch": true
    }
}

 

3.1.4.2.2. 失败示例

{
    "code": 500,
    "msg": "操作失败",
    "success": false,
}

工商企业四要素API

最近更新时间: 2024-01-24 15:12:07

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.3.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.3.2. 请求参数示例

{
      "accessKey":"87d0373b**********",

      "accessSecret":"b20d7c5e1c********************",
      "entName": "******",
      "entQualificationType": 1,
      "entQualificationNum": "******************",
      "corporateName": "***",
      "corporateIdCard": "******************"
}

 

3.1.4. 响应参数

3.1.4.1. 响应参数列表

编码

列表

参数类型

内容

备注

1) 

code

int

状态码

200成功、500失败

2) 

msg

String

认证结果描述

 

3) 

success

boolean

处理是否成功:

取值范围 truefalse

4) 

data

 

业务数据 如果失败则为空

 

5) 

status

int

认证状态

1 认证成功 2 认证失败

6) 

entNameMatch

boolean

企业名称匹配情况

true 成功、false失败

7) 

entQualificationNumMatch

boolean

企业资质编号匹配情况

true 成功、false失败

8) 

corporateNameMatch

boolean

企业法人代表姓名匹配情况

true 成功、false失败

9) 

corporateIdCardMatch

boolean

企业法人代表证件身份证号匹配情况

true 成功、false失败

 

3.1.4.2. 响应参数示例

3.1.4.2.1. 成功示例

{
    "code": 200,
    "msg": "操作成功",
    "success": true,
    "data": {
        "status": 1,
        "entNameMatch": true,
        "entQualificationNumMatch": true,
        "corporateNameMatch": true,
        "corporateIdCardMatch": true
    }
}

 

3.1.4.2.2. 失败示例

{
    "code": 500,
    "msg": "操作失败",
    "success": false,
}

加微咨询

一对一服务,更有优惠惊喜