API文档 关联关系 十大受益人
基本信息
接口地址
https://api.qixin.com/APIService/benefit/getTopTenBeneficiariesByName
数据格式
JSON
请求方式
GET
描述
获取企业的十大受益人信息。
请求参数 (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)
参数名类型必填描述
keyword String 企业全名/注册号/统一社会信用代码
响应参数
参数名类型长度描述
status
data.status
string 10 返回结果状态
sign
data.sign
string 32 数据签名
data
data.data
object 255 数据
message
data.message
string 255 返回结果消息
id
data.message.id
String 36 公司id
name
data.message.name
String 100 公司名
type
data.message.type
String 10 类型(E: 公司, P: 个人, UE: 其他)
beneficiary_list
data.message.beneficiary_list
array 0 十大受益人列表
uid
data.message.beneficiary_list.uid
String 36 公司id / 受益人id
name
data.message.beneficiary_list.name
String 100 公司名或受益人姓名
type
data.message.beneficiary_list.type
String 1 类型(E: 公司, P: 个人, UE: 其他)
relationPercentTotal
data.message.beneficiary_list.relationPercentTotal
String 10 该人/公司对目标企业的总持股比例
items
data.message.beneficiary_list.items
array 0 十大受益人的受益路径
id
data.message.beneficiary_list.items.id
String 36 公司id / 受益人id
name
data.message.beneficiary_list.items.name
String 100 公司名或受益人姓名
type
data.message.beneficiary_list.items.type
String 10 类型(E: 公司, P: 个人, UE: 其他)
relationPercent
data.message.beneficiary_list.items.relationPercent
String 10 该人/公司对目标企业在该路径下的总持股比例
breakThroughPercent
data.message.beneficiary_list.items.breakThroughPercent
String 10 该人/公司对目标企业在该路径下的穿透持股比例
path
data.message.beneficiary_list.items.path
String 5000 受益人投资路径,如(例如“xxx有限公司(100%)->南xxx有限公司”)
level
data.message.beneficiary_list.items.level
String 10 层级
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

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

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