中量智数
lianxi联系我们
工商信息类接口 / 工商企业股权穿透
icon

工商企业股权穿透

构建企业上下游股权穿透树。

GET

基本信息

接口地址
https://api.zlzstech.com.cn/api/v1/nexus/gongshang/siac/query/penetration
请求方式
GET
返回格式
JSON
接口描述
构建企业上下游股权穿透树。
适用场景
企业主体核验 / 工商信息查询 / 尽职调查

请求参数（Query）

字段名
是否必填
类型
描述
示例值
keyword
是
string
搜索关键词（企业名称或统一社会信用代码）
北京中量智数科技有限公司
keyword_type
否
string
关键词类型: 1-企业名称, 2-统一社会信用代码
1
up_depth
否
string
上游穿透层级，默认1，范围0-6
2
down_depth
否
string
下游穿透层级，默认1，范围0-6
2
force
否
string
是否强制重新查询（true/false/1/0，空值等价false）
false
max_nodes
否
string
最多构建节点数，默认200，范围1-2000
100
max_fanout
否
string
单节点上下游最大展开数量，默认50，范围1-200
20

响应字段

字段名
类型
描述
示例值
code
integer
Code
200
msg
string
Msg
OK
data
object
企业穿透结果
-
root
object
穿透树节点
-
company
object
穿透节点企业基础信息
-
credit_code
string
统一社会信用代码
91110108MA00000000
company_name
string
企业名称
北京中量智数科技有限公司
legal_name
string
法定代表人
-
company_status
string
企业状态
-
register_capital
string
注册资本
-
province
string
省
-
city
string
市
-
relation_from_parent
object
父子节点之间的股权关系信息
-
direction
string
关系方向 upstream/downstream
-
share_ratio
string
股权占比
-
subscribe_amount
string
认缴出资额
-
paid_amount
string
实缴出资额
-
holder_type
string
主体类型
-
src_name
string
出资方名称
-
src_credit_code
string
出资方统一社会信用代码
-
dst_name
string
被投资方名称
-
dst_credit_code
string
被投资方统一社会信用代码
-
upstream
array
上游节点列表
-
downstream
array
下游节点列表
-
meta
object
节点元信息
-
up_level
integer
相对根节点的上游层级
0
down_level
integer
相对根节点的下游层级
0
is_cycle
boolean
是否循环节点
false
is_truncated
boolean
是否因阈值截断
false
is_enterprise
boolean
是否企业节点
true
is_expanded
boolean
当前节点是否已执行过上下游展开
false
can_expand
boolean
当前节点是否支持继续展开
false
stats
object
穿透结果统计信息
-
requested_up_depth
integer
Requested Up Depth
0
requested_down_depth
integer
Requested Down Depth
0
max_nodes
integer
Max Nodes
100
max_fanout
integer
Max Fanout
20
visited_nodes
integer
Visited Nodes
0
truncated_nodes
integer
Truncated Nodes
0

错误码

说明：接口返回内容通常包含 code / msg / data。code 为 200 表示成功；非 200 时请根据 msg 提示处理。

错误码
错误信息
原因说明
处理建议
400
请求处理失败
请求内容未通过业务校验，或查询条件不完整。
根据返回提示调整请求参数；如参数确认无误，请联系技术支持排查。
401
认证失败
未提供 X-API-KEY，或接口密钥无效、已停用、已过期。
检查请求头 X-API-KEY 是否正确，并确认该密钥处于可用状态。
422
请求参数验证失败
必填参数缺失、参数类型不正确，或取值格式不符合接口要求。
检查必填参数、参数类型、枚举值和取值范围。
422000
参数取值不合法
部分参数取值不在允许范围内，例如开关值、类型值或层级范围。
按接口参数说明修正取值后重试。
429001
配额不足
当前账号可用接口调用配额不足。
联系商务或管理员增加套餐配额。
429002
未开通可用套餐
当前账号暂未开通可调用该类接口的有效套餐。
联系商务或管理员确认套餐与接口权限。
429003
配额配置暂不可用
当前调用额度配置暂时不可用。
稍后重试；持续出现时联系管理员确认配额配置。
429004
系统繁忙，请稍后重试
系统短时间内请求较多，暂时无法完成本次调用。
稍后重试，必要时降低并发请求。
429999
配额处理异常
调用额度处理过程中出现异常。
稍后重试；持续出现时联系技术支持。
500
服务异常
服务处理过程中出现异常。
稍后重试；持续出现时联系技术支持并提供请求时间与接口地址。

示例代码

cURL
curl -X GET "https://api.zlzstech.com.cn/api/v1/nexus/gongshang/siac/query/penetration?keyword=%E5%8C%97%E4%BA%AC%E4%B8%AD%E9%87%8F%E6%99%BA%E6%95%B0%E7%A7%91%E6%8A%80%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8&keyword_type=1&up_depth=2&down_depth=2&force=false&max_nodes=100&max_fanout=20" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key"

更新说明

版本号
发布日期
更新内容
v1.0.0
2024-04-22
接口文档初始化。

数据接口接入咨询

可根据风控尽调、客户准入、供应商管理、招投标核验等业务场景，组合接口字段、调用策略和接入方案。

企业微信：扫码添加咨询窗口

电话：13264420821（工作日 9:00 - 18:00）