查询 TMC 集成跳转权限

  • 接口：common/thirdparty/display/staff
  • Method：GET
  • 接口说明：分页查询指定 TMC 跳转按钮下的分配权限。

参数

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制
bizId String 业务唯一识别码 TRUE 255
timestamp Long 时间戳 TRUE 无
page_num Integer 页码，最小 1，默认 1 FALSE 无
page_size Integer 分页条数，仅支持 20、50、100、200，默认 200 FALSE 无
source String TMC 渠道，映射到权限表 platform TRUE 32
plat String 设备，枚举值：0 web、1 移动端 TRUE 无
position String 位置，枚举值：main、claim_header、claim_line TRUE 64
button_name String 按钮名称，对应跳转入口配置 name TRUE 64

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码
resMsg String 返回信息描述
bizId String 业务唯一识别码
data Object 分页结果
data.page_num Integer 当前页码
data.total_page Integer 总页数
data.page_size Integer 每页条数
data.total_count Long 总数
data.is_first_page Boolean 是否第一页
data.is_last_page Boolean 是否最后一页
data.page_info Array 权限项列表
data.page_info[].type String 名单类型，枚举值：white、black
data.page_info[].staff_type String 权限对象类型，枚举值：user、department、level
data.page_info[].staff_code String 员工号、部门编码或职级编码；历史数据无法反查时为 null
data.page_info[].description String 描述，对应权限表 comments
data.page_info[].child_include_flag String 是否包含子级，仅 staff_type=department 返回

业务规则

  • 按 company_id + plat + position + button_name 定位按钮，不使用 source 定位按钮。
  • 权限查询固定使用 action=sso，action_id 使用跳转入口配置 ID，source 映射到 trv_universal_staff.platform。
  • 按钮不存在返回业务失败。
  • 查询只返回当前页权限项；Outing 只对当前页数据做 staff_id -> staff_code 转换。
  • 历史权限项无法反查到人员、部门或职级主数据时，该权限项仍返回，staff_code 为 null。

请求示例

GET /common/thirdparty/display/staff?bizId=demo-find-display-staff&timestamp=1786532400000&page_num=1&page_size=20&source=ctrip&plat=0&position=main&button_name=ctrip_main

返回示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "demo-find-display-staff",
  "data": {
    "page_size": 20,
    "page_num": 1,
    "total_count": 1,
    "total_page": 1,
    "is_first_page": true,
    "is_last_page": true,
    "page_info": [
      {
        "type": "white",
        "description": "TMC跳转入口权限",
        "staff_type": "department",
        "staff_code": "D1",
        "child_include_flag": "Y"
      }
    ]
  }
}

results matching ""

    No results matching ""