疑似实际控制人信息
企业疑似实际控制人关系图谱查询
请求方式
- 请求地址:
http://api.shuidi.cn/open/suspectedActualControl
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/open/suspectedActualControl?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": {
"ratio": "1.0",
"controller": {
"name": "京东香港国际有限公司",
"type": "公司"
},
"graph": {
"v": {
"relationShips": [{
"start": "京东香港国际有限公司",
"end": "北京京东世纪贸易有限公司",
"type": "INVEST",
"percent": "1",
"flag": "标红"
}],
"nodes": [{
"name": "北京京东世纪贸易有限公司",
"type": "公司"
}, {
"name": "京东香港国际有限公司",
"type": "公司"
}]
},
"e": {
"relationShips": [{
"start": "京东香港国际有限公司",
"end": "北京京东世纪贸易有限公司",
"type": "INVEST",
"percent": "1",
"flag": null
}],
"nodes": [{
"name": "京东香港国际有限公司",
"type": "公司"
}, {
"name": "北京京东世纪贸易有限公司",
"type": "公司"
}]
}
}
}
}
输出结果字段含义
属性名 |
类型 |
含义 |
ratio |
String |
股权占比 |
controller |
Controller |
实际控制人 |
graph |
Graph |
关系图谱 |
Controller(实际控制人)
属性名 |
类型 |
含义 |
name |
String |
控制人名称 |
type |
String |
控制人类型: 人/公司 |
Graph(图谱)
属性名 |
类型 |
含义 |
v |
Verticle |
图谱中所有节点关系集合 |
e |
Edge |
图中的路径 |
Verticle(节点)
属性名 |
类型 |
含义 |
relationShips |
List |
连接关系集合 |
nodes |
List |
节点信息集合 |
RelationShip(关系)
属性名 |
类型 |
含义 |
start |
String |
起始结点 |
end |
String |
结束结点 |
type |
String |
自然人股东->公司,公司股东->公司,人->公司(仅限执行事务合伙人→合伙企业),公司->公司(仅限执行事务合伙人->合伙企业),总公司->分公司 |
percent |
String |
股份比例 |
flag |
String |
标识: 未标红/标红 |
Node(结点)
属性名 |
类型 |
含义 |
name |
String |
股东名 |
type |
String |
股东类型: 人/公司 |
错误编码
错误编码 |
说明 |
1 |
请求成功 |
2 |
未查询到数据 |
3 |
接口未授权 |
4 |
请求参数错误 |
30001 |
请求已过期 |
99999 |
系统错误 |