股权结构图接口
查询企业股权结构图谱
请求方式
- 请求地址:
http://api.shuidi.cn/ic/open/equityStructure
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/ic/open/equityStructure?pname=patest&ptime=1571990576623&vkey=2237ae09ea514c43a37ab0c57968f536&key=小米科技有限责任公司
接口认证
客户每次调用接口,必需包含接入ID(pname), 安全验证码(vkey)和时间戳(ptime).
参数名称 | 类型 | 是否必填 | 说明 | 示例值 |
---|---|---|---|---|
pname | String | 是 | 调用方唯一ID,用于身份识别 | patest |
ptime | String | 是 | 时间戳,从格林威治时间1970年01月01日00时00分00秒起至现在的时间,精确到毫秒(13位) | 1571990576623 |
vkey | String | 是 | 安全验证码。使用下划线依次连接pkey、ptime、pkey,计算该字符串的MD5值完成签名. 结果为32个字符 |
2237ae09ea514c43a37ab0c57968f536 |
Java计算vkey示例:
String ptime =String.valueOf(System.currentTimeMillis());
SecureUtil.md5(pkey + "_" + ptime + "_" + pkey);
php计算vkey示例:
$vkey=md5($pkey.”_”.$ptime.”_”.$pkey)
请求参数
参数名称 | 类型 | 是否必填 | 说明 | 示例 |
---|---|---|---|---|
key | String | 是 | 搜索关键字(公司名、注册号或社会统一信用代码) | 小米科技有限责任公司 |
响应结果
返回数据格式
所有接口返回值以JSON字符串的形式返回给调用者,JSON格式如下:
{ "statusCode": 1, "statusMessage": "请求成功", "data": {} }
返回JSON属性如下:
属性 | 说明 |
---|---|
statusCode | 返回查询结果编码 |
statusMessage | statusCode不为1时的错误信息描述。 |
data | 结果数据。不同接口,data的内容会有所不同。具体见各接口返回说明。 |
响应示例
{
"statusCode": 1,
"statusMessage": "请求成功",
"data": {
"companyName": "小米科技有限责任公司",
"companyType": "1",
"stockPercent": "100%",
"isAbsoluteControl": "True",
"level": "1",
"legalPerson": "雷军",
"inParentActualPercent": "0",
"paths": [{
"name": "雷军",
"stockType": "自然人股东",
"capital": "143934.0478万元",
"stockPercent": "77.8022%"
}],
"children": [
{
"companyName": "雷军",
"companyType": "2",
"stockType": "自然人股东",
"stockPercent": "77.8022%",
"stockCapital": "143934.0478万元",
"isAbsoluteControl": "True",
"level": "2",
"legalPerson": null,
"inParentActualPercent": "0.778022",
"children": null
}, {
"companyName": "黎万强",
"companyType": "2",
"stockType": "自然人股东",
"stockPercent": "10.1213%",
"stockCapital": "18724.3569万元",
"isAbsoluteControl": "False",
"level": "2",
"legalPerson": null,
"inParentActualPercent": "0.101213",
"children": null
}, {
"companyName": "洪锋",
"companyType": "2",
"stockType": "自然人股东",
"stockPercent": "10.0665%",
"stockCapital": "18623.099万元",
"isAbsoluteControl": "False",
"level": "2",
"legalPerson": null,
"inParentActualPercent": "0.100665",
"children": null
}, {
"companyName": "刘德",
"companyType": "2",
"stockType": "自然人股东",
"stockPercent": "2.0100%",
"stockCapital": "3718.4963万元",
"isAbsoluteControl": "False",
"level": "2",
"legalPerson": null,
"inParentActualPercent": "0.0201",
"children": null
}]
}
}
输出结果字段含义
属性名 | 类型 | 含义 |
---|---|---|
companyName | String | 公司名字 |
companyType | String | 公司类别 1:公司 2:个人 |
stockPercent | String | 出资比例 |
isAbsoluteControl | String | 是否绝对控股 |
level | String | 对应的层级 |
legalPerson | String | 法人代表 |
inParentActualPercent | String | 当前股东所在公司在该公司父级中所占实际比例 |
paths | List |
疑似实际控制人 |
children | List |
控股企业 |
paths(疑似实际控制人)
属性名 | 类型 | 含义 |
---|---|---|
name | String | 实际控股名称 |
stockType | String | 实际控股类型 |
capital | String | 出资额 |
stockPercent | String | 出资比例 |
Children(控股企业)
属性名 | 类型 | 含义 |
---|---|---|
companyName | String | 公司名字 |
companyType | String | 公司类别 1:公司 2:个人 |
stockType | String | 股东类型 |
stockPercent | String | 出资比例 |
stockCapital | String | 出资金额 |
isAbsoluteControl | String | 是否绝对控股 |
level | String | 对应的层级 |
legalPerson | String | 法人代表 |
inParentActualPercent | String | 当前股东所在公司在该公司父级中所占实际比例 |
children | List |
错误编码
错误编码 | 说明 |
---|---|
1 | 请求成功 |
2 | 未查询到数据 |
3 | 接口未授权 |
4 | 请求参数错误 |
30001 | 请求已过期 |
99999 | 系统错误 |