# 企业股比数据查询
# 接口描述
查询指定企业的股比数据,包括股东名、股东类型、认缴金额、实缴金额等信息。
# 字符编码
UTF-8
# 请求地址
/openapi/enterprise/best_stock_info
# 请求 Header 参数
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
accessToken | String | 是 | 请求发起时需要在 header 中,携带 accessToken,获取方式详见获取 accessToken |
# 版本号(ver)
1
# 请求方式
POST(application/json)
# 请求 Body 参数
参数名 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
ver | Integer | - | 必填 | api 接口版本,参见具体 API 的版本。示例:1 |
creditCode | String | 255 | 非必填 | 统一社会信用代码 |
companyName | String | 255 | 非必填 | 企业名称 |
pageNum | Integer | - | 非必填 | 页数,默认1 |
pageSize | Integer | - | 非必填 | 每页条数,默认20条,最多20条 |
isHistory | Integer | 3 | 非必填 | 是否是历史数据 1:是,0:否 |
conDateStart | String | 10 | 否 | 出资日期-开始 |
conDateEnd | String | 10 | 否 | 出资日期-结束 |
# 请求 Body 示例
{
"ver":1,
"creditCode":"91420000757013137P",
"pageSize":1,
"pageNum":1
}
1
2
3
4
5
6
2
3
4
5
6
# 应用级返回结果
参数名 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
data | bestStockInfo[] | - | 否 | 返回数据 |
totalCount | Integer | - | 是 | 总条数 |
pageNum | Integer | - | 是 | 页数 |
pageSize | Integer | - | 是 | 每页条数 |
dataCnt | Integer | - | 是 | 实际数据条数 |
# bestStockInfo 属性值对象
参数名 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
id | Integer | 20 | 是 | id |
stockName | String | 255 | 否 | 股东名 |
stockId | String | 36 | 否 | 股东id |
stockType | String | 255 | 否 | 股东类型 |
shareType | String | 255 | 否 | 股份类型 |
stockPercent | Integer | 40 | 否 | 出资比例 |
shouldCapiConv | Integer | 40 | 否 | 认缴额(万)人民币 |
shouldCapi | Integer | 40 | 否 | 认缴额(万) |
realCapi | Integer | 40 | 否 | 实缴额(万) |
currencyCode | String | 20 | 否 | 币种编码 详见货币字典表 |
stockNum | Integer | 40 | 否 | 持股数 |
conDate | String | 10 | 否 | 出资日期 |
isHistory | Integer | 3 | 否 | 是否历史1:历史;0:非历史 |
# 返回结果示例
{
"code": 200,
"data": {
"list": [{
"id": "5054661212",
"stockName": "中国建筑第三工程局有限公司",
"stockId": "b47a620ae5a3ca03703a1893d7f7e11b",
"stockType": "其它",
"shareType": "国家股",
"stockPercent": "1",
"shouldCapiConv": "0",
"shouldCapi": "0",
"realCapi": "0",
"currencyCode": null,
"stockNum": "15318000000",
"conDate": null,
"isHistory": 0
}],
"totalCount": 1,
"pageNum": 1,
"pageSize": 1,
"dataCnt": 1
},
"msg": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
返回code码见 API 返回码说明