API REFERENCE主体识别与基础信息文档可用

企业公开联系方式与触点

查询企业公开联系方式、官方域名、社交媒体与职能邮箱，并核验来源。

POST/go-api/api/v1/companies/web-contacts/detail

认证用户 JWT

数据服务商情据 · A 平台

当前单价尚未发布

参数位置JSON 请求体

REQUEST EXAMPLE

cURL 请求示例

curl --request POST 'https://shangqingju.com/go-api/api/v1/companies/web-contacts/detail' \
  --header 'Authorization: Bearer YOUR_USER_JWT' \
  --header 'Content-Type: application/json' \
  --data '{
  "eid": "YOUR_COMPANY_EID"
}'

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

请求参数 2 个字段

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

字段 / 类型	说明
`eid` *string · 必填	企业 EID 使用企业搜索结果中的 EID，不能用企业名称代替。
`website`string · 可选	企业官网可选，用于辅助定位企业的官方网络信息。

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

返回字段

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

字段 / 类型	内容
`company_identity`object	企业身份，包括 EID、企业名称、国家及注册识别信息。
`contacts_summary`object	totalWebContacts、totalCount、returnedCount、truncated。
`contacts.items[]`array	contactType、contactValue、department、verificationStatus、evidenceUrl、sourceName、sourceUrl、sourceRetrievedAt、confidenceScore。

响应信封结构

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

{
  "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 不等同于用户钱包扣费，请以商情据账务流水为准。收费请求不会自动重试。