开发工具

获取用户部门路径

开发中

GET

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

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

说明

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

例如：

用户所在部门结构示例

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

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

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

请求参数

Path 参数

endpoint_url

string

必需

示例值:

userId

string

必需

Header 参数

X-Shimo-Token

string

必需

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

array [array]

可选

object

可选

string

必需

接入方系统的部门 ID

name

string

必需

接入方系统的部门名称

示例

成功示例（用户仅属于一个部门）成功示例（用户属于多个部门）

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

修改于 2024-03-19 08:39:24

获取用户水印信息

批量获取用户信息