获取客服详情

更新坐席（数组化参数 + 覆盖 / 清空语义）

PUT /api/v1/supports/{supportId}.json
Authorization: Bearer <token>
Content-Type: application/json

请求体

{
  "support": {
    "name": "张三更新",
    "mobile": "13900139000",
    "groupId": [1, 3],
    "role": [1],
    "module": [5],
    "custom_fields": [
      {"key": "address", "value": "上海"}
    ]
  }
}

数组字段语义（重要）

字段	语义	示例
module	全量覆盖：按数组开通模块，并关闭该坐席不在数组中的其他已授权模块	`[5]` → 只保留在线客服；`[]` → 清空全部模块授权
role	全量覆盖：绑定即为终态；`[]` → 清空全部角色	`[1]` → 只保留角色 1；`[]` → 无角色
groupId	全量覆盖：有变化时先删后插	`[1,3]` → 分组变为 1、3

增量

变更模块时请使用第 3/4 节的 module_grant /module_revoke（两者互不冲突：更新坐席管终态，授权接口管增量）。
只传需要修改的字段，未传字段保持不变；仅传 {} 会返回 110042 There is no valid update value 。

成功响应：返回更新后的坐席完整信息（含 roles / granted_modules / groupId）。

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "support": {
        "sId": "718120",
        "sPassportName": "way-dream",
        "groupId": "337783",
        "sNum": "0010203",
        "name": "dream",
        "gnder": "2",
        "email": "wang96fei@163.com",
        "fixnumber": "",
        "mobile": "18366121588",
        "QQ": "",
        "isAdmin": "1",
        "createDT": "2019-12-26 17:51:22",
        "roles": [
            {
                "roleId": "98467",
                "roleName": "管理员"
            }
        ],
        "granted_modules": [
            {
                "mId": "5",
                "module": "在线客服"
            },
            {
                "mId": "6",
                "module": "工单客服"
            }
        ],
        "custom_fields": [
            {
                "key": "field_12",
                "value": "0"
            },
            {
                "key": "field_13",
                "value": "wangjuan@rdc.gnway.com"
            },
            {
                "key": "field_14",
                "value": ""
            },
            {
                "key": "field_15",
                "value": "0"
            },
            {
                "key": "field_16",
                "value": "0.00"
            },
            {
                "key": "field_17",
                "value": "否"
            },
            {
                "key": "field_18",
                "value": ""
            },
            {
                "key": "field_19",
                "value": ""
            },
            {
                "key": "field_20",
                "value": ""
            },
            {
                "key": "field_21",
                "value": ""
            },
            {
                "key": "field_22",
                "value": []
            },
            {
                "key": "field_23",
                "value": ""
            },
            {
                "key": "field_24",
                "value": "0"
            }
        ]
    }
}

更新坐席（数组化参数 + 覆盖 / 清空语义）

请求参数

请求示例代码

返回响应

获取客服详情

更新坐席（数组化参数 + 覆盖 / 清空语义）#

请求参数

请求示例代码

返回响应

更新坐席（数组化参数 + 覆盖 / 清空语义）