传播脉络接口

## 效果

![](/media/202208/2022-08-26_164120_801551.png)

![](/media/202208/2022-08-26_173839_928187.png)

## 前端技术参考

[echats 脉络地址](https://echarts.apache.org/v4/examples/en/editor.html?c=graph-force "echats 脉络地址")
```json
name: '拓扑图',
                    type: 'graph',
                    layout: 'force',
                    force: {
                        // initLayout: 'circular',
                        edgeLength: [10, 50],
                        repulsion: 50,
                        layoutAnimation: true
                    },
```
## 获取作品传播脉络统计接口
- **接口描述：**根据作品ID，查询作品传播脉络数据。支持全部以及分页，3000为限制。一次返回200
- **接口地址：**`/api/v1/preview/statistic/relation?token=TOKEN&creationId=xxx&relationId=XXX&level=XXX`
- **请求方式：**`GET`
- **传参方式：**
- **注意事项：**
- 查询作品传播脉络数据。支持全部以及分页，3000为限制。一次返回200
- 脉络中的层级统计柱状图是t-1 例如想看2022-09-08日数据，需要2022-09-09才能看到
- 脉络节点数，统计暂时为五分钟。也就是分享后的，五分钟左右能看到传播节点
- **参数列表：**
| **参数名** | **是否必须** | **参数类型** | **说明** |
| --- | --- | --- | --- |
| creationId | 是 | Long | 作品ID |
| relationId | 否 | String | 非全部数据时，点击节点的ID，类似分页 |
| level | 否 | String | 非全部数据时，点击节点的层级，类似分页 |

- **代码示例：**
```json
{
	"success": true,
	"code": 200,
	"msg": "操作成功",
	"obj": {
		"a": true,
		"ns": [{
			"id": "0",
			"c": "",
			"n": "原始场景",
			"i": "",
			"v": 4,
			"l": 0
		}, {
			"id": "199101",
			"c": "oYy90xF3jqmmTksJkVx_TKqcGQ3g",
			"n": "古月加贝七小",
			"i": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTIe03vErEZH1Sw2vD25LAy65zuhDyaicw5tOsEqCDwmdIJLYLrQXWSReoNu2mibibam6CyQ4yjSJj6Ow/132",
			"v": 0,
			"l": 1
		}, {
			"id": "251783",
			"c": "oYy90xH-YzuAEBWaa6Z83gZUS0tE",
			"n": "Lonsy²⁰²¹",
			"i": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTJAUlVzuuhU0VPOez901dntGxCqncq7hic7OPCaPyQgoI2oEHia79uNp2bukHv43XkNOlbdI3ia1lTGQ/132",
			"v": 0,
			"l": 1
		}, {
			"id": "252212",
			"c": "oYy90xJlqhiZ1QcCSIgDTyTHcB30",
			"n": "古时之月",
			"i": "https://thirdwx.qlogo.cn/mmopen/vi_32/wlPQLBd2uYa66LfC7718AxeI6aEpdtVojIZriaBrpNPAMQxEmPD1pscARpbkJYgh5Mp214faBKueV1nicRGtaRow/132",
			"v": 0,
			"l": 1
		}, {
			"id": "1390813",
			"c": "oYy90xD3wQnIsfJ7hX7-5Pf8JiKI",
			"n": "小婧婧\uD83D\uDC33",
			"i": "https://thirdwx.qlogo.cn/mmopen/vi_32/2ibjm8Kiay7p2oJNHgibGB07a9brBWjGZiaLKkickHakZaCCN0UfZnm5dTNg3MlViciazYZpI1gtFsobcgGNO2ftCian9Q/132",
			"v": 0,
			"l": 1
		}],
		"ls": [{
			"s": "0",
			"t": "199101"
		}, {
			"s": "0",
			"t": "251783"
		}, {
			"s": "0",
			"t": "252212"
		}, {
			"s": "0",
			"t": "1390813"
		}]
	},
	"map": null,
	"list": null
}
```
- **返回参数obj：**
因为节点渲染问题，默认返回限制为3000，当作品传播节点在限制之下，一次返回全部，当作品传播超过限制时，默认一次返回第一层级，最多200节点，之后每次进行分页再次调用，一次默认返回200，接入者需要进行分别追加进上次返回节点【ns】联络【ls】如果上次的节点是其他【other开头】需要删除节点【ns】中最后一个然后再追加，
| **参数** | **参数类型** | **说明** |
| --- | --- | --- |
|a|boolean|true 返回全部，false 返回部分,当为false值时，点击每个节点需要再次调用接口，传递参数relation为该节点id,level为该节点level|
|ns|object[]|节点数组，nodes简称 ns|
|ls|object[]|链接数组 links简称 ls|

- **返回参数ns：**
| **参数** | **参数类型** | **说明** |
| --- | --- | --- |
|id|String|节点唯一标识,特别说明ohter开头的为其他|
|c|string|客户唯一标识，customerId简写，微信公众授权为openId,手机号授权为手机号，第三方授权为第三方访客ID，接口返回的userId|
|n|String|名称 name简写|
|i|String|头像 image简写|
|v|int|子节点数量，value简写|
|l|int|层级最多7层 level 简写|
- **返回参数ls：**
| **参数** | **参数类型** | **说明** |
| --- | --- | --- |
|t|string|目标 target|
|s|String|源 source|