企业基本信息查询
输入企业名称或统一社会信用代码,即可查询企业工商相关信息。返回企业信息,包括法人、联系方式、注册资本、信用代码、登记机关、经营状态、电话号码等。
官网购买的套餐通过API调用时请使用“扣套餐次数”密钥进行调用
GEThttps://api.shuxuntech.com/v1/enterprise_base_info/query
¥0.05元 / 次
阶梯计价,用量越大单价越低
企业认证后额外赠送 666 次调用额度
01 — 接口说明
请求参数与返回结果
所有请求需在 header 中携带签名信息,body 参数按 x-www-form-urlencoded 提交
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| appKey | head | string | 是 | 数勋分配appKey |
| timestamp | head | string | 是 | 当前时间的毫秒数 |
| sign | head | string | 是 | 签名,说明 |
| keyword | query | string | 是 | 企业名称或统一社会信用代码或注册号 |
签名算法说明
数勋分配的appKey、当前unix时间毫秒数timestamp、数勋分配的appSecret、 按顺序拼接sha256加密得到sign,查看如下示例
appKey = aaa;timestamp = 1682476904289;appSecret = bbb;sign = sha256(appKey+timestamp+appSecret)02 — 返回说明
返回结构与字段含义
顶层返回 code 与 msg,业务数据在 data 对象内,各字段含义见下方表格
返回字段描述
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | string | 错误码 |
| msg | string | 错误描述 |
| isFee | int | 是否计费(1:计费,0:不计费) |
| seqNo | string | 调用流水号 |
| data | object | 返回数据 |
data对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| result | int | 核查结果(1:查询成功,2:查询无记录) |
| info | object | 查询数据 |
info对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| companyName | string | 公司名称 |
| creditCode | string | 统一社会信用代码 |
| orgNumber | string | 组织机构代码 |
| companyType | string | 企业类型 |
| keyPersonName | string | 法人 |
| keyPersonType | string | 法人类型 |
| regCapital | string | 注册资本 |
| actualCapital | string | 实缴资本 |
| province | string | 省份 |
| provinceCode | string | 省份编码 |
| city | string | 城市 |
| cityCode | string | 城市编号 |
| district | string | 区县 |
| districtCode | string | 区县编号 |
| regNumber | string | 注册号 |
| authority | string | 登记机关 |
| regLocation | string | 注册地址 |
| regStatus | string | 运营状态 |
| businessScope | string | 经营范围 |
| establishTime | string | 成立时间 |
| approvedTime | string | 核准日期 |
| termStart | string | 运营时间从 |
| termEnd | string | 运营商时间至 |
| lastUpdatedTime | string | 更新时间 |
| historyNames | string | 历史曾用名 |
| industry | object | 行业信息 |
| contacts | object | 联系信息 |
industry对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| industry | string | 行业门类描述 |
| industryCode | string | 行业描述code |
| subIndustry | string | 行业大类描述 |
| subIndustryCode | string | 行业大类code |
| middleCategory | string | 行业中类描述 |
| middleCategoryCode | string | 行业中类code |
| smallCategory | string | 行业小类描述 |
| smallCategoryCode | string | 行业小类code |
contacts对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| address | array | 注册地址 |
| phoneNumber | array | 电话号码 |
| array | 邮箱 | |
| website | array | 官网 |
code错误码说明
| code | 说明 |
|---|---|
| 0 | 成功 |
| 1 | 参数错误 |
| 2 | 无记录 |
| 3 | 第三方服务异常 |
| 4 | 签名错误 |
| 5 | 余额不足 |
| 6 | 调用频率超限 |
| 7 | 账号停用 |
| 8 | 接口已停用 |
| 9 | 联系服务商开通接口权限 |
| 10 | ip不在白名单 |
| 11 | 系统异常 |
| 12 | 实名状态错误 |
| 99 | 其他异常,具体返回为准 |
返回示例
正确返回
{ "code": "0", "msg": "成功", "isFee": 1, "seqNo": "dz1a92u7kgqdjslnwruqfamkibz5cbf0", "data": { "result": 1, "info": { "companyName": "上海***投资发展(集团)有限公司",//公司名称 "creditCode": "91310000774***709",//统一社会信用代码 "orgNumber": "7743***70",//组织机构代码 "companyType": "有限责任公司(自然人投资或控股)",//企业类型 "keyPersonName": "喻**", //法人 "keyPersonType": "自然人",// 法人类型 "regCapital": "50000.000000万人民币",// 注册资本 "actualCapital": "50000.000000万人民币",//实缴资本 "province": "上海市",//省份 "provinceCode": "310000",//省份编码 "city": "上海市",//城市 "cityCode": "310000",//城市编号 "district": "青浦区",//区县 "districtCode": "310118",//区县编号 "regNumber": "310229001029350",//注册号 "authority": "青浦区市场监督管理局",//登记机关 "regLocation": "上海市***区**公路***弄***层",//注册地址 "regStatus": "存续(在营、开业、在册)",//运营状态 "businessScope": "许可项目:道路货物运输;货物进出口;技术进出口;食品经营。(依法须经批准的项目,经相关部门批准后方可开展经营活动,具体经营项目以相关部门批准文件或许可证件为准)\r\n一般项目:实业投资;社会经济咨询服务;国内货物运输代理;技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广;法律咨询(不包括律师事务所业务);财务咨询。(除依法须经批准的项目外,凭营业执照依法自主开展经营活动)",//经营范围 "establishTime": "2005-04-19 00:00:00",//成立时间 "approvedTime": "2020-12-28 00:00:00",//核准日期 "termStart": "2005-04-19 00:00:00",//运营时间从 "termEnd": "2025-04-18 00:00:00",//运营商时间至 "lastUpdatedTime": "2024-05-09 23:50:06",//更新时间 "historyNames": "上海***(集团)有限公司,上海***有限公司",//历史曾用名 "industry": {//行业信息 "industry": "金融业",//行业门类描述 "industryCode": "J",//行业描述code "subIndustry": "其他金融业",//行业大类描述 "subIndustryCode": "69",//行业大类code "middleCategory": "其他未列明金融业",//行业中类描述 "middleCategoryCode": "699",//行业中类code "smallCategory": "其他未包括金融业",//行业小类描述 "smallCategoryCode": "6999"//行业小类code }, "contacts": {//联系信息 "address": [//注册地址 { "note": "b2b", "value": "上海市市辖区**区**镇**区**镇**公路***号" } ], "phoneNumber": [//电话号码 { "note": "b2b", "value": "(021)6***7777" } ], "email": [//邮箱 { "note": "2014年报", "value": "059***wf@163.com" }, { "note": "2014年报", "value": "059***wf@163.com" } ], "website": []//官网 } } }}错误返回
{ "code": "1", "msg": "参数不能为空", "isFee": 0, "seqNo": null, "data": null}03 — 代码示例
七种语言,复制即用
签名规则:sha256(appKey + timestamp + appSecret),下列示例已包含完整签名流程
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.security.MessageDigest;
/**
* 企业基础信息查询 - Java 示例代码
* 接口地址:https://api.shuxuntech.com/v1/enterprise_base_info/query
*
* 说明:本示例只使用 JDK 原生 API(java.net / java.security),不依赖任何第三方 jar 包,
* 也不需要本项目的工具类,复制到本地即可编译运行:
* javac EnterpriseBaseInfoQueryDemo.java
* java EnterpriseBaseInfoQueryDemo
*/
public class EnterpriseBaseInfoQueryDemo {
/** 数勋分配的 appKey,请替换为您自己的 appKey */
private static final String APP_KEY = "您的appKey";
/** 数勋分配的 appSecret,请替换为您自己的 appSecret */
private static final String APP_SECRET = "您的appSecret";
/** 接口地址 */
private static final String API_URL = "https://api.shuxuntech.com/v1/enterprise_base_info/query";
/** 企业名称或统一社会信用代码或注册号 */
private static final String KEYWORD = "";
public static void main(String[] args) throws Exception {
// 1、当前 unix 时间毫秒值,服务端要求与服务器时间相差不能超过 5 分钟
String timestamp = String.valueOf(System.currentTimeMillis());
// 2、签名:按顺序拼接 appKey + timestamp + appSecret 后做 sha256,得到小写十六进制字符串
String sign = sha256Hex(APP_KEY + timestamp + APP_SECRET);
// 3、业务参数,拼到 url 的 query 里
String query = "keyword=" + urlEncode(KEYWORD);
String url = API_URL + (query.isEmpty() ? "" : "?" + query);
// 4、发起 GET 请求,appKey、timestamp、sign 放在请求头
HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("appKey", APP_KEY);
conn.setRequestProperty("timestamp", timestamp);
conn.setRequestProperty("sign", sign);
conn.setConnectTimeout(10000);
conn.setReadTimeout(20000);
int status = conn.getResponseCode();
// 5、读取返回内容:报错时读错误流,避免只拿到一个异常看不到原因
InputStream in = (status >= 200 && status < 300) ? conn.getInputStream() : conn.getErrorStream();
String result = readAll(in);
conn.disconnect();
System.out.println("HTTP状态码=" + status);
System.out.println("返回结果=" + result);
}
/**
* sha256 加密,返回小写十六进制字符串
* 服务端校验签名用的就是这个算法(小写十六进制)
*/
private static String sha256Hex(String content) throws Exception {
byte[] bytes = MessageDigest.getInstance("SHA-256").digest(content.getBytes("UTF-8"));
StringBuilder sb = new StringBuilder(bytes.length * 2);
for (byte b : bytes) {
sb.append(Character.forDigit((b >> 4) & 0xF, 16));
sb.append(Character.forDigit(b & 0xF, 16));
}
return sb.toString();
}
/** url 编码,中文参数需要编码 */
private static String urlEncode(String value) throws Exception {
return URLEncoder.encode(value, "UTF-8");
}
/** 读取输入流内容 */
private static String readAll(InputStream in) throws Exception {
if (in == null) {
return "";
}
StringBuilder sb = new StringBuilder();
BufferedReader reader = new BufferedReader(new InputStreamReader(in, "UTF-8"));
try {
String line;
while ((line = reader.readLine()) != null) {
sb.append(line);
}
} finally {
reader.close();
}
return sb.toString();
}
}04 — 在线调试
先调通,再决定
用你自己的数据发一次真实请求,表单字段随接口定义自动生成,返回结果附字段注释
请求参数
按接口定义自动生成
- keyword*企业名称或统一社会信用代码或注册号
appKey / timestamp / sign调用时自动按 sha256 生成,无需手填
appKey=未获取 · timestamp=实时生成 · sign=自动生成
这是真实调用,会消耗套餐次数或账户余额; 请勿用真实证件信息反复试调
返回结果
点击左侧「提交并调用接口」,参数会就地组装、按文档口径签名后直接请求接口, 返回的 JSON 显示在这里。
在线调试使用你自己的 appKey,按实际调用计费。
05 — 产品价格
阶梯计价,用多少买多少
单次价格随调用量阶梯下降,大档位单价最低
| 调用量 | 价格 | 单价 |
|---|---|---|
| 20 次 | ¥ 0 | ¥ 0 |
| 100 次 | ¥ 8 | ¥ 0.08 |
| 500 次 | ¥ 40 | ¥ 0.08 |
| 1,000 次 | ¥ 75 | ¥ 0.075 |
| 5,000 次 | ¥ 350 | ¥ 0.07 |
| 10,000 次 | ¥ 650 | ¥ 0.065 |
| 20,000 次 | ¥ 1,200 | ¥ 0.06 |
| 50,000 次 | ¥ 2,800 | ¥ 0.056 |
| 100,000 次 | ¥ 5,000 | ¥ 0.05 |