API文档 工商信息 最优股比信息
基本信息
接口地址
https://api.qixin.com/APIService/enterprise/getShareHolderByName
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/enterprise/getShareHolderByName?name=云南友众科技有限公司
描述
启信宝根据大数据算法,综合多源数据算出的股比数据
请求参数 (Headers)
参数名类型必填描述
Auth-Version String 2.0(参数值),固定传入:2.0
appkey String 启信慧眼数据开放平台获取 ,获取方式:个人中心-安全中心-API 密钥,获取appkey的同时,请完成IP白名单的配置:个人中心-安全中心-API IP白名单设置,如未配置,接口调试会报错“104 未添加IP白名单”
timestamp String UNIX时间戳,精确到毫秒,示例:1656921036000,当前系统时间近10分钟有效
sign String 请求认证签名,对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果,小写字符串(实际加密不带入‘+’)
请求参数 (Query)
参数名类型必填描述
name String 企业全名/注册号/统一社会信用代码
skip Number 跳过条目数(默认为0,单页返回20条数据)
响应参数
参数名类型长度描述
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
sign
data.sign
String 32 数据签名
data
data.data
Object 0 返回查询结果,如果没有匹配记录则返回空。具体字段含义见下表
total
data.data.total
Number 10 返回列表中记录总数
items
data.data.items
Array 0 数据列表
name
data.data.items.name
String 255 股东名称
type
data.data.items.type
String 10 类型(E-企业,P-其他)
shType
data.data.items.shType
String 255 股东类型
creditNo
data.data.items.creditNo
String 40 统一社会信用代码
investAmountCNY
data.data.items.investAmountCNY
String 40 投资金额(认缴金额,转换为人民币万元)
percent
data.data.items.percent
String 40 占股比
shouldCapiNum
data.data.items.shouldCapiNum
String 40 认缴金额(万)
shouldCapiDate
data.data.items.shouldCapiDate
String 64 认缴出资日期
realCapi
data.data.items.realCapi
String 64 实缴金额(万)
realCapidate
data.data.items.realCapidate
String 64 实缴出资日期
currencyCode
data.data.items.currencyCode
String 40 币种代码
stockNum
data.data.items.stockNum
String 40 持股数量(适用于上市公司)
standardType
data.data.items.standardType
String 255 标准股东类型
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "4542b13d6906417584f3dcb7b4c270b6",
    "data": {
        "items": [
            {
                "name": "上海合合信息科技股份有限公司",
                "type": "E",
                "shType": "",
                "creditNo": "91310110791485269J",
                "investAmountCNY": "30000",
                "percent": "100.00%",
                "shouldCapiDate": "2026-12-31",
                "realCapidate": "2025-06-05",
                "shouldCapiNum": "30000",
                "realCapi": "25000",
                "currencyCode": "CNY",
                "stockNum": "0",
                "standardType": "自然人股东"
            }
        ],
        "total": 1
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/enterprise/getShareHolderByName';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');

let urlParams = {
    name: 'name的值',
    skip: 'skip的值'
}

let concatParams = []
for (let key in urlParams) {
    concatParams.push(key + '=' + urlParams[key]);
}

let options = {
    'method': 'GET',
    'url': baseUrl + '?' + concatParams.join('&'),
    'headers': {
        'Connection': 'keep-alive',
        'Auth-version': '2.0',
        'appkey': appkey,
        'timestamp': timeStamp,
        'sign': sign
    }
};

request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});