编辑(联系人/企业)共享人
POST https://qw-openapi-tx.dustess.com/customerTeam/v1/changeSharer?accessToken=
Content-Type: application/json
程序执行时,每行请求(
params
)参数会有独立的结果(data.results
);params
最大100条, 超过后整体报错系统
为身份进行操作,会跨过客户权限,但无法为公海中的客户进行添加共享人(这是业务限制);结果返回值为该字段类型零值时会缺省该字段信息(例如
data.results.code
);字段 | 类型 | 描述 | 是否必须 |
---|---|---|---|
accessToken | String | accessToken | true |
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
cusType | String | 客户类型: 目前可选: 企业(仅企业管理模式下可用):COMPANY ; 联系人: CONTACT | true |
params | Object[] | 请求参数列表(最大单次100条) | true |
params.id | String | 客户的ID(联系人或企业的ID, 具体类型 与 cusType 对应) | true |
params.addSharerIDs | String[] | 添加为共享人的员工ID列表 | false |
params.removeSharerIDs | String[] | 需移除共享人的员工ID列表 | false |
json
- Request-Example:{
"cusType": "COMPANY",
"params": [
{
"id": "8fa857b9-2c7a-11ef-bbb2-c67f141a806f",
"addSharerIDs": [
"173"
],
"removeSharerIDs": [
"74"
]
}
]
}
响应参数名 | 类型 | 说明 |
---|---|---|
code | Int | 响应码 |
msg | String | 消息提示 |
success | Bool | 是否成功 |
data | Object | 响应数据 |
data.results | Object[] | 行更新结果 |
data.results.id | String | 行结果客户ID |
data.results.code | String | 行结果Code码, 0为成功 |
data.results.msg | String | 行结果文案 |
{
"code": 0,
"data": {
"results": [
{
"code": "0",
"id": "f41b788c-3907-11ef-9beb-ce03d7e8c38a",
"msg": ""
},
{
"code": "0",
"id": "2dfcc875-38f5-11ef-9beb-ce03d7e8c38a",
"msg": ""
}
]
},
"msg": "OK",
"success": true,
"traceId": "e2fde8fd-0079-9fc4-bef9-f86140c3996c"
}
**错误响应示例**
```json
{
"success": false,
"code": 21000,
"msg": "系统异常",
}
修改于 2024-11-19 09:24:48