删除 TMC 集成跳转权限

  • 接口:common/thirdparty/display/staff/delete
  • Method:POST
  • 接口说明:批量删除指定 TMC 跳转按钮下的分配权限。

参数

请求参数

请求体为 OutingBaseRequest 包装结构,删除条件位于 data 内。

字段名称 字段类型 字段描述 是否必填 长度限制
bizId String 业务唯一识别码 TRUE 255
timestamp Long 时间戳 TRUE 无
data.source String TMC 渠道,映射到权限表 platform TRUE 32
data.plat String 设备,枚举值:0 web、1 移动端 TRUE 无
data.position String 位置,枚举值:main、claim_header、claim_line TRUE 64
data.button_name String 按钮名称,对应跳转入口配置 name TRUE 64
data.staff_list Array 权限项列表,最多 500 条 TRUE 无
data.staff_list[].type String 名单类型,枚举值:white、black TRUE 16
data.staff_list[].staff_type String 权限对象类型,枚举值:user、department、level TRUE 64
data.staff_list[].staff_code String 员工号、部门编码或职级编码 TRUE 无

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码
resMsg String 返回信息描述
bizId String 业务唯一识别码
data.validatorErrors Array Outing 侧校验或 code/id 转换失败,元素包含 code、messages
data.warnings Array 警告信息,元素包含 code、messages
data.dbErrors Array Warmachine 侧单条失败,元素包含 code、messages;待删除记录不存在进入该集合
data.deleted String 删除成功数量描述

业务规则

  • Outing 校验公共参数、按钮定位参数、staff_list 非空且最多 500 条。
  • Outing 将 staff_code 转换为 staff_id 后调用 Warmachine;转换失败的条目不传给 Warmachine。
  • staff_type=user 时 staff_code 为员工号;staff_type=department 时为部门编码;staff_type=level 时为职级编码。
  • Warmachine 按 company_id + plat + position + button_name 定位按钮,不使用 source 定位按钮。
  • 删除条件为 company_id + source/platform + action=sso + action_id + type + staff_type + staff_id。
  • 待删除记录不存在不阻止其他存在记录删除。
  • 所有条目均为 Outing 侧校验或转换失败且整包级参数合法时,仍返回成功响应,失败详情在 validatorErrors,不会调用 Warmachine 删除。

请求示例

{
  "bizId": "demo-delete-display-staff",
  "timestamp": 1786532400000,
  "data": {
    "source": "ctrip",
    "plat": "0",
    "position": "main",
    "button_name": "ctrip_main",
    "staff_list": [
      {
        "type": "white",
        "staff_type": "department",
        "staff_code": "D1"
      }
    ]
  }
}

返回示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "demo-delete-display-staff",
  "data": {
    "validatorErrors": [],
    "warnings": [],
    "dbErrors": [],
    "deleted": "此次请求删除成功了1条数据"
  }
}

results matching ""

    No results matching ""