You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
74 lines
2.3 KiB
74 lines
2.3 KiB
meta {
|
|
name: 图谱全量读
|
|
type: http
|
|
seq: 1
|
|
tags: [
|
|
generated
|
|
]
|
|
}
|
|
|
|
get {
|
|
url: {{baseUrl}}/api/customer/contact/graph/detail?customerId=753314901191032832
|
|
body: none
|
|
auth: inherit
|
|
}
|
|
|
|
params:query {
|
|
customerId: 753314901191032832
|
|
}
|
|
|
|
docs {
|
|
# 图谱全量读
|
|
`GET /api/customer/contact/graph/detail`（本行兼作对账钥匙，勿手改）
|
|
节点+手动边+版本号；电话脱敏，公司边由前端按 level==10 派生（D8）；首次读懒建版本行。布局纯由 level 推导（y=等级行、x=行内稳定序），零坐标数据。
|
|
|
|
## 请求参数
|
|
|
|
| 参数 | 类型 | 必填 | 默认 | 说明 |
|
|
| --- | --- | --- | --- | --- |
|
|
| customerId | string | 是 | - | 客户 id（查询参数） |
|
|
|
|
## 请求示例
|
|
|
|
请求头：Authorization: Bearer {{token}}
|
|
|
|
GET /api/customer/contact/graph/detail?customerId=753314901191032832
|
|
|
|
## 响应 data 结构
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| version | number | 图谱版本号（save 乐观锁比对口径；联系人增删等节点集变化也会 bump） |
|
|
| nodes | array | 节点集（该客户全部联系人；公司节点不在 nodes 内，由前端按 level==10 派生） |
|
|
| nodes[].contactId | string | 联系人 id |
|
|
| nodes[].name | string | 联系人姓名 |
|
|
| nodes[].jobTitleName | string | 职务名称 |
|
|
| nodes[].jobTitleCategory | string | 职务类别（一级类别文本） |
|
|
| nodes[].level | number | 等级 1–10（10=顶层）；null=未设置等级（右侧栏） |
|
|
| nodes[].levelSource | number | 等级来源：1=字典跟随 2=手工锁定（spec D2） |
|
|
| nodes[].phoneMasked | string | 联系电话（脱敏 138****1234；明文走 reveal 端点） |
|
|
| nodes[].isKeyContact | number | 是否关键联系人（1/0） |
|
|
| edges | array | 手动边集（全量终态；公司边不在此列） |
|
|
| edges[].parentId | string | 上级联系人 id（level 高者） |
|
|
| edges[].childId | string | 下级联系人 id（level 低者） |
|
|
|
|
## 错误码
|
|
|
|
- 67002 客户不存在或已被删除（无权访问同码）
|
|
|
|
## 响应示例
|
|
|
|
// 示例数据（E2E 实测真值），字段结构以上表为准
|
|
```json
|
|
{
|
|
"code": 0,
|
|
"success": true,
|
|
"message": "success",
|
|
"data": {
|
|
"version": 0,
|
|
"nodes": [],
|
|
"edges": []
|
|
}
|
|
}
|
|
```
|
|
}
|
|
|