股权结构图接口


查询企业股权结构图谱

请求方式

  • 请求地址: 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 系统错误

results matching ""

    No results matching ""