API文档 关联关系 企业族谱穿透信息
基本信息
接口地址
https://api.qixin.com/APIService/report/getEntRelationReportByName
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/report/getEntRelationReportByName?name=上海合合信息科技股份有限公司&direction=2&level=2&totpercent=0.5
描述
企业的十二层股权穿透,包括六层对外投资(向下)和六层股东(向上)穿透详细信息,并可自定义穿透持股比例和层级,并且支持返回Excel可视化报告
请求参数 (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 企业全名/注册号/统一社会信用代码
direction Number 股权穿透类型:1-股东股权穿透,2-对外投资穿透
level Number 穿透层级,1-6(默认为3)
totpercent Number 企业股权占比最小值,0-1(默认为0.05,当传入0的时候,为不限股比返回所有的数据,包含股比为空值的情况,其他指定值无法返回股比为空值的情况)
form Number 输出格式,0为Json,1为excel(默认为0)
响应参数
参数名类型长度描述
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
sign
data.sign
String 32 数据签名
data
data.data
Object 0 返回查询结果, 如果没有匹配记录则返回为空。具体字段 含义见下表
name
data.data.name
String 255 企业名称
type
data.data.type
String 255 穿透类型,1-股东股权穿透,2-对外投资穿透
equity_path
data.data.equity_path
Array 0 持股路径,当请求入参form=0时,返回该字段
entity_eid
data.data.equity_path.entity_eid
String 36 企业id
entity_name
data.data.equity_path.entity_name
String 255 企业名称
credit_no
data.data.equity_path.credit_no
String 255 统一社会信用代码
status
data.data.equity_path.status
String 255 企业状态
total_equity_percent
data.data.equity_path.total_equity_percent
String 255 总持股比例
equity_compute_process
data.data.equity_path.equity_compute_process
String 255 计算过程
single_equity_path_list
data.data.equity_path.single_equity_path_list
Array 0 单条持股路径列表
level
data.data.equity_path.single_equity_path_list.level
String 255 层级
type
data.data.equity_path.single_equity_path_list.type
String 255 持股方式,枚举:直接、间接
should_capi
data.data.equity_path.single_equity_path_list.should_capi
String 255 认缴出资
equity_percent
data.data.equity_path.single_equity_path_list.equity_percent
String 255 单条路径总持股
level1_entity_eid
data.data.equity_path.single_equity_path_list.level1_entity_eid
String 36 公司1id
level1_entity_name
data.data.equity_path.single_equity_path_list.level1_entity_name
String 255 公司1名称
level1_percent
data.data.equity_path.single_equity_path_list.level1_percent
String 255 股比1
level2_entity_eid
data.data.equity_path.single_equity_path_list.level2_entity_eid
String 36 公司2id
level2_entity_name
data.data.equity_path.single_equity_path_list.level2_entity_name
String 255 公司2名称
level2_percent
data.data.equity_path.single_equity_path_list.level2_percent
String 255 股比2
level3_entity_eid
data.data.equity_path.single_equity_path_list.level3_entity_eid
String 36 公司3id
level3_entity_name
data.data.equity_path.single_equity_path_list.level3_entity_name
String 255 公司3名称
level3_percent
data.data.equity_path.single_equity_path_list.level3_percent
String 255 股比3
level4_entity_eid
data.data.equity_path.single_equity_path_list.level4_entity_eid
String 36 公司4id
level4_entity_name
data.data.equity_path.single_equity_path_list.level4_entity_name
String 255 公司4名称
level4_percent
data.data.equity_path.single_equity_path_list.level4_percent
String 255 股比4
level5_entity_eid
data.data.equity_path.single_equity_path_list.level5_entity_eid
String 36 公司5id
level5_entity_name
data.data.equity_path.single_equity_path_list.level5_entity_name
String 255 公司5名称
level5_percent
data.data.equity_path.single_equity_path_list.level5_percent
String 255 股比5
level6_entity_eid
data.data.equity_path.single_equity_path_list.level6_entity_eid
String 36 公司6id
level6_entity_name
data.data.equity_path.single_equity_path_list.level6_entity_name
String 255 公司6名称
level6_percent
data.data.equity_path.single_equity_path_list.level6_percent
String 255 股比6
level7_entity_eid
data.data.equity_path.single_equity_path_list.level7_entity_eid
String 36 公司7id
level7_entity_name
data.data.equity_path.single_equity_path_list.level7_entity_name
String 255 公司7名称
doc_path
data.data.doc_path
String 0 文件下载路径,当入参form=1时返回该字段
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "9f3af66034f64e1025411b6806f1420c",
    "data": {
        "name": "上海合合信息科技股份有限公司",
        "type": "对外投资穿透",
        "equity_path": [
            {
                "entity_eid": "034a2177-2af7-4989-9367-ea611190d8c9",
                "entity_name": "上海找贝数据科技有限公司",
                "credit_no": "91310106MA1FYAQT84",
                "status": "存续",
                "total_equity_percent": "100.00000000%",
                "equity_compute_process": "100.0%",
                "single_equity_path_list": [
                    {
                        "level": "1",
                        "type": "直接",
                        "should_capi": "100.0",
                        "equity_percent": "100.00%",
                        "level1_entity_eid": "e8cdf5e0-97ad-4e1e-a8e4-29358f8a9866",
                        "level1_entity_name": "上海合合信息科技股份有限公司",
                        "level1_percent": "100.0%",
                        "level2_entity_eid": "034a2177-2af7-4989-9367-ea611190d8c9",
                        "level2_entity_name": "上海找贝数据科技有限公司",
                        "level2_percent": "",
                        "level3_entity_eid": "",
                        "level3_entity_name": "",
                        "level3_percent": "",
                        "level4_entity_eid": "",
                        "level4_entity_name": "",
                        "level4_percent": "",
                        "level5_entity_eid": "",
                        "level5_entity_name": "",
                        "level5_percent": "",
                        "level6_entity_eid": "",
                        "level6_entity_name": "",
                        "level6_percent": "",
                        "level7_entity_eid": "",
                        "level7_entity_name": ""
                    }
                ]
            }
        ]
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/report/getEntRelationReportByName';
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的值',
    direction: 'direction的值',
    level: 'level的值',
    totpercent: 'totpercent的值',
    form: 'form的值'
}

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);
});