logo
logo
请输入关键词搜索产品或者文档

热门搜索

中国

中国站

创蓝云智

国际站

Innopaas

首页企业工商信息 开发文档

开发文档

更新时间：2026-07-08T16:01:49

1、工商企业二要素核验

1.1 协议说明

名称说明
协议HTTPS POST
编码格式UTF8
Content-Typeapplication/json
URLhttps://wsapi.253.com/open/dynamic2/gsxx/twoElementsCheck

1.2 请求参数

请求参数以 application/json 方式提交

参数名类型说明
appIdString请在https://www.chuanglan.com/ 登录后获取
appKeyString请在https://www.chuanglan.com/ 登录后获取
credit_codeString注册号/社会统一信用代码
ent_nameString企业名称

1.3 响应内容

返回参数字段，数据为 JSON 格式。

字段名类型说明
codeString响应 code 码。200000：成功 400001: 参数校验异常(详情见 message 字段)其他失败(参考创蓝官方状态码)
messageString响应 code 码解释
reqIdObject业务唯一流水号
chargeStatusString是否收费，枚举值：1 ：收费 0：不收费
chargeCountString收费条数
dataObject返回对象
ent_name_matchString企业名称认证结果(-1：无法验证；0：不一致；1：一致)
credit_code_matchString社会统一信用代码认证结果(-1：无法验证；0：不一致；1：一致)

1.4响应示例

  • 调用返回一致示例：
复制成功
{
    "code": "200000",
    "message": "success",
    "reqId": "2702703855033257988",
    "chargeStatus": 1,
    "chargeCount": "1",
    "data": {
        "ent_name_match": "1",
        "credit_code_match": "1"
    }
}
  • 调用返回不一致示例：
复制成功
{
    "code": "200000",
    "message": "success",
    "reqId": "2702703855033257988",
    "chargeStatus": 1,
    "chargeCount": "1",
    "data": {
        "ent_name_match": "0",
        "credit_code_match": "0"
    }
}
  • 调用返回异常库无示例：
复制成功
{
    "code": "200000",
    "message": "success",
    "reqId": "2702703855033257988",
    "chargeStatus": 1,
    "chargeCount": "1",
    "data": {
        "ent_name_match": null,
        "credit_code_match": null
    }
}

2、企业三要素核验

2.1 协议说明

名称说明
协议HTTPS POST
编码格式UTF8
Content-Typeapplication/json
URLhttps://wsapi.253.com/open/gsxx/business-three-auth

2.2 请求参数

请求参数Body以multipart/form-data方式提交

参数名类型说明
appIdString请在https://www.chuanglan.com/ 登录后获取
appKeyString请在https://www.chuanglan.com/ 登录后获取
entNameString企业名称
legalPerNameString法人姓名
creditCodeString统一信用代码

2.3 响应内容

返回参数字段，数据为 JSON 格式。

字段名类型说明
codeString响应 code 码。200000：成功 400001: 参数校验异常(详情见 message 字段)其他失败(参考创蓝官方状态码)
msgString响应 code 码解释
reqIdObject业务唯一流水号
chargeStatusString是否收费，枚举值：1 ：收费 0：不收费
dataObject返回对象
entNameMatchString企业名称认证结果：-1:无法验证；0：不一致； 1：一致（建议联系创蓝运营提交OrderNO排查问题）
creditCodeMatchString社会统一信用代码认证结果：-1:无法验证；0：不一致；1：一致（建议联系创蓝运营提交OrderNO排查问题）
legalPerNameMatchString法人认证结果：0：不一致；1：一致；（建议联系创蓝运营提交OrderNO排查问题）

2.4响应示例

  • 调用返回成功示例：
复制成功
{
    "code": "200000",
    "msg": "success",
    "reqId": "3063006183620030483",
    "chargeStatus": 1,
    "data": {
        "entNameMatch": "1",
        "creditCodeMatch": "1",
        "legalPerNameMatch": "1"
    }
}
  • 调用返回失败示例：
复制成功
{
    "code": "500000",
    "message": "企业名称不能为空",
    "reqId": "1009355518074387166",
    "chargeStatus": 0,
    "data": null
}

备注： 企业三要素是一种有关企业实名认证的应用程序接口（API），包括：企业的名称、统一社会信用代码和法人代表姓名（因为无核验身份证号码，所以同名不同人无法区分）。企业三要素核验的目的是通过数据库资料对这三个要素进行核验，以确定企业信息是否真实

3、企业工商四要素核验

3.1 协议说明

名称说明
协议HTTPS POST
编码格式UTF8
Content-Typeapplication/json
URLhttps://api.253.com/open/gsxx/business-four-auth

3.2 请求参数

请求参数 Body 以 multipart/form-data 方式提交。

参数名说明
appId请在https://www.chuanglan.com/登录后获取
appKey请在https://www.chuanglan.com/登录后获取
entName企业全名
legalPerName法人姓名
creditCode统一信用代码
idNum法人身份证号

3.3 响应内容

响应 body 数据为 JSON 格式。

字段名类型说明
chargeStatusString是否收费，枚举值：1 ：收费 0：不收费
codeString响应 code 码。200000：成功 400001: 参数校验异常(详情见 message 字段)其他失败(参考创蓝官方状态码)
messageString响应 code 码解释
dataObject返回对象
orderNoString业务唯一流水号
handleTimeString处理时间 例：2018-04-09 15:05:01
resultString返回结果码 01: 一致 02: 不一致 03: 不确定(库无)04: 通道调用异常，原因可能是：输入参数有误，通道异常等，具体可参考 remark 字段(注：result=01, 02 计费，其他不计费)
remarkStringresult 结果码描述说明
companyNameMatchString企业核验结果(1-一致,2-不一致,3-无法验证)
creditCodeMatchString社会统一信用号核验结果(1-一致,2-不一致,3-无法验证)
legalPerNameMatchString法人姓名核验结果(1-一致,2-不一致,3-无法验证）
idNoMatchString法人证件号核验结果(1-一致,2-不一致,3-无法验证)

4、企业四要素精准版核验

4.1 协议说明

名称说明
协议HTTPS POST
编码格式UTF8
Content-Typeapplication/json
URLhttps://wsapi.253.com/open/auth/enterpriseFour/enterpriseFourElementsAccurate

4.2 请求参数

请求参数application/json 数据提交

参数名类型说明
appIdString请在https://www.chuanglan.com/ 登录后获取
appKeyString请在https://www.chuanglan.com/ 登录后获取
ent_nameString企业名称
legal_per_nameString法人姓名
credit_codeString统一信用代码
id_noString法人身份证

4.3 响应内容

返回参数字段，数据为 JSON 格式。

字段名类型说明
codeString响应 code 码。200000：成功 400001: 参数校验异常(详情见 message 字段)其他失败(参考创蓝官方状态码)
messageString响应 code 码解释
reqIdString业务唯一流水号
chargeStatusString是否收费，枚举值：1 ：收费 0：不收费
chargeCountString收费条数
dataObject返回对象
data>>ent_name_matchObject企业名称认证结果(-1：⽆法验证；0：不⼀致；1：⼀致)
data>>credit_code_matchString社会统⼀信⽤代码认证结果(-1：⽆法验证；0：不⼀致；1：⼀致)
data>>legal_per_name_matchString法⼈姓名认证结果(-1：⽆法验证；0：不⼀致；1：⼀致)
data>>id_no_matchString法⼈⾝份证号码认证结果(-1：⽆法验证；0：不⼀致；1：⼀致)

4.4响应示例

  • 调用返回一致示例：
复制成功
{
  "code": "200000",
  "message": "success",
  "reqId": "2702703855033257988",
  "chargeStatus": 1,
  "chargeCount": "1",
  "data": {
      "ent_name_match": "1",
      "legal_per_name_match": "1",
      "credit_code_match": "1",
      "id_no_match": "1"
    }
}
  • 调用返回不一致示例：
复制成功
{ 
  "code": "200000",
  "message": "success",
  "reqId": "2702703855033257988",
  "chargeStatus": 1,
  "chargeCount": "1",
  "data": {
      "ent_name_match": "0",
      "legal_per_name_match": "0",
      "credit_code_match": "0",
      "id_no_match": "0"
    }
}
  • 调用返回异常库无示例：
复制成功
{
  "code": "200000",
  "message": "success",
  "reqId": "2702703855033257988",
  "chargeStatus": 1,
  "chargeCount": "1",
  "data": {
      "ent_name_match": null,
      "legal_per_name_match": null,
      "credit_code_match": null,
      "id_no_match": null
    }
}

5、企业工商模糊查询

5.1 协议说明

名称说明
协议HTTPS POST
编码格式UTF8
Content-Typeapplication/json
URLhttps://wsapi.253.com/open/gsxx/enterpriseQuery

5.2 请求参数

请求参数Body以multipart/form-data方式提交

参数名类型说明
appIdString请在https://www.chuanglan.com/ 登录后获取
appKeyString请在https://www.chuanglan.com/ 登录后获取
entNameString企业名称关键字

5.3 响应内容

返回参数字段，数据为 JSON 格式。

字段名类型说明
codeString响应 code 码。200000：成功 500000: 失败
messageString响应 code 码解释
reqIdString请求Id
chargeCountString计费条数
chargeStatusint是否收费，枚举值：1 ：收费 0：不收费
dataArray企业信息
entnameString企业名称
creditCodeString统一社会信用代码

5.4响应示例

  • 成功返回示例：
复制成功
{
  "code": "200000",
  "message": "success",
  "reqId": "4279011161960366774",
  "chargeStatus": 1,
  "chargeCount": "1",
  "data": [
    {
      "entname": "xx科技有限责任公司"
    },
    {
      "entname": "xx通讯技术有限公司"
    },
    {
      "entname": "xx之家商业有限公司"
    },
    {
      "entname": "北京xx移动软件有限公司"
    },
    {
      "entname": "xx科技（武汉）有限公司"
    },
    {
      "entname": "广东xx科技有限责任公司"
    },
    {
      "entname": "重庆市xx小额贷款有限公司"
    },
    {
      "entname": "江苏中利电子信息科技有限公司"
    },
    {
      "entname": "山西沁州黄xx（集团）有限公司"
    },
    {
      "entname": "湖北xx长江产业基金合伙企业（有限合伙）"
    }
  ]
}
  • 失败返回示例：
复制成功
{
    "code": "500000",
    "message": "企业名称不能为空",
    "reqId": "4279011161960366779",
    "chargeStatus": 0,
    "data": null
}
没有更多了
没有上一篇
没有下一篇
文档目录
收缩
24小时热线 400-9669-253
产品推荐
验证码短信
通知短信
国际验证码短信
视频短信
5G融合消息
行为验证码
其他产品
国内语音消息
活体检测SDK
短信LOGO认证
解决方案
注册登录
新客获客
老客激活
电商行业
游戏行业
餐饮行业
关于我们
关于我们
智慧党建
常见问题
开发者中心
创蓝社区
logo

公司地址：上海市松江区广富林东路199号4栋9楼

24小时热线：400-9669-253
微信

创蓝公众号

企业微信

联系商务

上海创蓝云智信息科技股份有限公司版权所有Copyright © 2026 ALL RIGHTS RESERVED
增值电信业务经营许可证：B2-20144076沪ICP备案：15046301号-2 15046301号-16创蓝云智沪公网安备案 31011702001190号/31011702008034号创蓝云智