开发工具

获取用户部门路径

开发中

GET{endpoint_url}/users/{userId}/department-paths

获取指定用户的部门路径，若用户尚未分配部门，则返回空数组。

:::caution 说明

部门路径是指从用户所属部门到一级部门的路径节点列表。

:::

例如：

用户所在部门结构示例

XX 公司效率团队      // 团队层级
└── XX 研发部       // 一级部门
    └── 基础设置组
        └── 后端组  // 用户所属部门

该用户应返回的部门路径示例

[
  "XX 研发部",
  "基础设置组",
  "后端组"
]

请求参数

Path 参数

endpoint_url

string

必需

示例值:

userId

string

必需

Header 参数

X-Shimo-Token

string

必需

用于接入方对本次请求鉴权

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

array [array]

可选

object

可选

string

必需

接入方系统的部门 ID

name

string

必需

接入方系统的部门名称

[
  [
    {
      "id": "123",
      "name": "XX 研发部"
    },
    {
      "id": "456",
      "name": "基础设施组"
    },
    {
      "id": "789",
      "name": "后端组"
    }
  ]
]

最后修改时间： a year ago