API文档 关联关系 实际控制人
基本信息
接口地址
https://api.qixin.com/APIService/entChart/getActualOwnerByName
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/entChart/getActualOwnerByName?name=滴滴出行科技有限公司
描述
指企业的实际控制企业或自然人,根据《公司法》第216条的定义,是指虽然不是公司的股东,但通过投资关系、协议或者其他安排,能够实际支配公司行为的人。
请求参数 (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 企业全名/注册号/统一社会信用代码
响应参数
参数名类型长度描述
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
sign
data.sign
String 32 数据签名
data
data.data
Object 0 返回查询结果,具体字段 含义见下表
nodes
data.data.nodes
Array 0 节点信息列表
uid
data.data.nodes.uid
String 36 节点实体标识符
name
data.data.nodes.name
String 255 节点实体名称
id
data.data.nodes.id
String 36 节点 id
type
data.data.nodes.type
String 255 实体类型, E:企业,P:个人,UE: 未在工商注册的企业,U:类似社会公众 股、自然人股东、法人股等
creditNo
data.data.nodes.creditNo
String 255 统一社会信用代码
isKey
data.data.nodes.isKey
String 10 标识是否是疑似实际控制人节点或者查 询企业节点
links
data.data.links
Array 0 路径信息列表
sourceId
data.data.links.sourceId
Number 255 路径开始节点 id
targetId
data.data.links.targetId
Number 255 路径结束节点 id
type
data.data.links.type
String 255 关系类型
properties
data.data.links.properties
Object 0 关系属性
relationPercent
data.data.links.properties.relationPercent
String 255 控股比例
relationAmount
data.data.links.properties.relationAmount
String 255 控股金额
relationPercentSuspected
data.data.links.properties.relationPercentSuspected
String 255 疑似控股比例
relationDescDetail
data.data.links.properties.relationDescDetail
String 255 关系类型描述
relationLrDescDetail
data.data.links.properties.relationLrDescDetail
String 255 控制关系描述(执行事务合伙人)
isMainPath
data.data.links.properties.isMainPath
String 255 控制路径,1 为控制路径,非控制路径为0
creditNo
data.data.creditNo
String 255 被查询企业的统一社会信用代码
totalPercent
data.data.totalPercent
Number 255 疑似实际控制人的控股比
entityName
data.data.entityName
String 255 实控人名称
entityId
data.data.entityId
String 36 实际控制人id
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "d49183572fe645d7a4e041057f250fea",
    "data": {
        "nodes": [
            {
                "uid": "1ff0afa29f2fe205919aa06ea80b5635",
                "name": "镇立新",
                "id": 1,
                "type": "P",
                "isKey": "true",
                "creditNo": ""
            },
            {
                "uid": "8d9244f0-aa16-4972-8929-ff5f2579f111",
                "name": "上海目一然投资中心(有限合伙)",
                "id": 2,
                "type": "E",
                "isKey": "false",
                "creditNo": "91310110MA1G80904G"
            },
            {
                "uid": "e8cdf5e0-97ad-4e1e-a8e4-29358f8a9866",
                "name": "上海合合信息科技股份有限公司",
                "id": 3,
                "type": "E",
                "isKey": "true",
                "creditNo": "91310110791485269J"
            },
            {
                "uid": "f50e296e-c423-49b6-9c0e-876f0f22ef0f",
                "name": "上海狮吼投资管理有限责任公司",
                "id": 4,
                "type": "E",
                "isKey": "false",
                "creditNo": "91310110MA1G800A97"
            }
        ],
        "links": [
            {
                "sourceId": 1,
                "targetId": 3,
                "type": "SH",
                "properties": {
                    "relationPercent": "0.2419",
                    "relationAmount": "",
                    "relationPercentSuspected": "0.2419",
                    "relationDescDetail": "工商股东",
                    "isMainPath": "1",
                    "relationLrDescDetail": "公示实控人"
                }
            },
            {
                "sourceId": 1,
                "targetId": 4,
                "type": "SH",
                "properties": {
                    "relationPercent": "0.9",
                    "relationAmount": "",
                    "relationPercentSuspected": "0.9",
                    "relationDescDetail": "工商股东",
                    "isMainPath": "1",
                    "relationLrDescDetail": ""
                }
            },
            {
                "sourceId": 2,
                "targetId": 3,
                "type": "SH",
                "properties": {
                    "relationPercent": "0.0289",
                    "relationAmount": "",
                    "relationPercentSuspected": "0.0289",
                    "relationDescDetail": "工商股东",
                    "isMainPath": "1",
                    "relationLrDescDetail": ""
                }
            },
            {
                "sourceId": 4,
                "targetId": 2,
                "type": "SH",
                "properties": {
                    "relationPercent": "0.4473",
                    "relationAmount": "",
                    "relationPercentSuspected": "0.4473",
                    "relationDescDetail": "工商股东",
                    "isMainPath": "1",
                    "relationLrDescDetail": "执行事务合伙人"
                }
            }
        ],
        "totalPercent": 0.253534,
        "entityName": "镇立新",
        "entityId": "1ff0afa29f2fe205919aa06ea80b5635",
        "creditNo": "91310110791485269J"
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/entChart/getActualOwnerByName';
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的值'
}

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