1. Development Integration
  2. /
  3. Standard Web Application
  4. /
  5. Python
  6. /

  7. 管理模块

  8. /

  9. 用户管理

  10. /
  11. 获取用户部门列表

获取用户部门列表

Update time: 2025-07-23 07:34:21
Edit

通过用户 ID，获取用户部门列表，支持分页，可以选择获取自定义数据、选择指定用户 ID 类型、增序或降序等。

请求参数

名称类型必填默认值描述示例值
userIdstring是-用户 ID。6229ffaxxxxxxxxcade3e3d9
userIdTypestring否user_id用户 ID 类型，可以指定为用户 ID、手机号、邮箱、用户名和 externalId。。 枚举值：user_id,external_id,phone,email,usernameuser_id
pagenumber否1当前页数，从 1 开始。1
limitnumber否10每页数目，最大不能超过 50，默认为 10。10
withCustomDataboolean否-是否获取自定义数据。true
sortBystring否JoinDepartmentAt排序依据，如 部门创建时间、加入部门时间、部门名称、部门标志符。 枚举值：DepartmentCreatedAt,JoinDepartmentAt,DepartmentName,DepartmemtCodeJoinDepartmentAt
orderBystring否Desc增序或降序。 枚举值：Asc,DescDesc

示例代码

from authing import ManagementClient

management_client = ManagementClient(
    access_key_id="GEN_AUTH_USERPOOL_ID",
    access_key_secret="GEN_AUTH_USERPOOL_SECRET",
)

data = management_client.get_user_departments(

      user_id: "6229ffaxxxxxxxxcade3e3d9",

      user_id_type: "user_id",

      page: 1,

      limit: 10,

      with_custom_data: true,

      sort_by: "JoinDepartmentAt",

      order_by: "Desc",

)

请求响应

类型： UserDepartmentPaginatedRespDto

名称类型描述
statusCodenumber业务状态码，可以通过此状态码判断操作是否成功，200 表示成功。
messagestring描述信息
apiCodenumber细分错误码，可通过此错误码得到具体的错误类型。
dataUserDepartmentPagingDto响应数据

示例结果：

{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "list": {
      "organizationCode": "steamory",
      "departmentId": "60b49eb83fd80adb96f26e68",
      "createdAt": "2022-07-03T02:20:30.000Z",
      "name": "dd8d7stf44",
      "description": "dd8d7stf44",
      "openDepartmentId": "ou_7dab8a3d3cdccxxxxxx777c7ad535d62",
      "isLeader": true,
      "code": "6229c4deb3e4d8a20b6021ff",
      "isMainDepartment": true,
      "joinedAt": "2022-07-03T02:20:30.000Z",
      "i18n": {
        "name": {
          "zh-CN": {
            "enabled": false,
            "value": "中文"
          },
          "en-US": {
            "enabled": false,
            "value": "English"
          }
        }
      },
      "customData": {
        "icon": "https://example.com/logo"
      }
    }
  }
}

数据结构

UserDepartmentPagingDto

名称类型必填描述
totalCountnumber是记录总数。
listarray是响应数据。嵌套类型：UserDepartmentRespDto。

UserDepartmentRespDto

名称类型必填描述
organizationCodestring是组织 Code（organizationCode）。 示例值： steamory
departmentIdstring是部门 ID。 示例值： 60b49eb83fd80adb96f26e68
createdAtstring是部门创建时间。 示例值： 2022-07-03T02:20:30.000Z
namestring是部门名称。 示例值： dd8d7stf44
descriptionstring是部门描述。 示例值： dd8d7stf44
openDepartmentIdstring否自定义部门 ID，用于存储自定义的 ID。 示例值： ou_7dab8a3d3cdccxxxxxx777c7ad535d62
isLeaderboolean是是否是部门 Leader。 示例值： true
codestring是部门识别码。 示例值： 6229c4deb3e4d8a20b6021ff
isMainDepartmentboolean是是否是主部门。 示例值： true
joinedAtstring是加入部门时间。 示例值： 2022-07-03T02:20:30.000Z
isVirtualNodeboolean是是否是虚拟部门。
i18n否多语言设置。嵌套类型：I18nDto。 示例值： [object Object]
customDataobject否部门的扩展字段数据。 示例值： [object Object]

I18nDto

名称类型必填描述
name是支持多语言的字段。嵌套类型：LangObject。 示例值： [object Object]

LangObject

名称类型必填描述
zh-CN是多语言的中文内容。嵌套类型：LangUnit。 示例值： [object Object]
en-US是多语言的英文内容。嵌套类型：LangUnit。 示例值： [object Object]

LangUnit

名称类型必填描述
enabledboolean是是否已开启。若开启，且控制台选择该语言，则展示该内容。（默认关闭）。
valueboolean是多语言内容。