API REFERENCE经营表现与财务运营文档可用

企业投资地图

查询直接及间接投资、参股、控股、关系层级和国家分布。

POST/go-api/api/v1/companies/investment-map

认证用户 JWT

数据服务商情据 · A 平台

当前单价尚未发布

参数位置JSON 请求体

REQUEST EXAMPLE

cURL 请求示例

curl --request POST 'https://shangqingju.com/go-api/api/v1/companies/investment-map' \
  --header 'Authorization: Bearer YOUR_USER_JWT' \
  --header 'Content-Type: application/json' \
  --data '{
  "includeDirect": true,
  "includeIndirect": true,
  "maxLevel": 2,
  "eid": "YOUR_COMPANY_EID"
}'

示例使用占位凭证，可在窗口内横向或纵向滚动查看。

请求参数 4 个字段

字段名对应当前商情据接口；带 * 的字段必填。

字段 / 类型	说明
`eid` *string · 必填	企业 EID 使用企业搜索结果中的 EID，不能用企业名称代替。
`includeDirect`boolean · 可选	包含直接投资包含直接投资建议值：`true`
`includeIndirect`boolean · 可选	包含间接投资包含间接投资建议值：`true`
`maxLevel`integer · 可选	关系层级关系层级，取值 1–4。建议值：`2`

字段说明依据《A 平台接口文档》第 22 页，并与商情据当前请求结构核对。响应内容以实际返回为准。

返回字段

业务对象位于 data.data.result；请同时检查外层 code 与内层 success。

字段 / 类型	内容
`company_identity`object	企业身份，包括 EID、企业名称、国家及注册识别信息。
`investment_companies`array	被投企业、比例、路径、关系类型及层级。
`investment_summary`object	路径数、企业数、直接投资数等汇总。
`countries`array	国家分布。
`maDeals / ma_deals`array	相关并购。

响应信封结构

以下是结构示例，不是查询结果或扣费凭证。

{
  "code": 200,
  "errorCode": 0,
  "msg": "<返回信息>",
  "isCost": "<1 或 0>",
  "requestId": "<request-id>",
  "data": {
    "success": true,
    "error": null,
    "request_id": "<provider-request-id>",
    "data": {
      "operation_code": "<operation-code>",
      "credits_charged": "<计费点数>",
      "tool_calls": [],
      "result": "<下表中的业务对象>"
    }
  }
}

使用商情据账号认证

在用户端注册账号，或调用 POST /go-api/user/login 获取自己的登录凭证。
请求头设置 Authorization: Bearer YOUR_USER_JWT。
确认服务单价后发起查询；失败时保存查询编号，用于核对结果和账务。

所有请求通过 HTTPS。示例不包含你的实际凭证；不要把登录密码或 JWT 发布到公开代码仓库。

业务状态码

`200`	成功，仍需检查内层 success
`1 / 401`	认证失败，重新登录
`201`	没有查到数据
`402`	余额不足
`403`	无权限或接口停用
`429`	请求过于频繁
`500 / 501`	服务或上游异常
`999`	接口未适配

上游 isCost / credits_charged 不等同于用户钱包扣费，请以商情据账务流水为准。收费请求不会自动重试。