获取部门信息 - 探马OpenAPI

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

deptIds

array[number]

部门ID

必需

最大支持100

示例

{
    "deptIds": [
        20564,
        18672,
        20209,
        20621,
        18712,
        18811,
        18822
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/v3/get-department' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "deptIds": [
        20564,
        18672,
        20209,
        20621,
        18712,
        18811,
        18822
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

message

string

信息

必需

data

array [object {8}]

数据

必需

id

number

部门ID

必需

name

string

部门名称

必需

parentId

number

父级部门ID

必需

0代表根部门

qwId

number

企微部门ID

必需

企微唯一标识

qwParentId

number

企微父级部门ID

必需

企微唯一标识

createTime

string

创建时间

必需

格式：yyyy-MM-dd HH:mm:ss

updateTime

string

修改时间

可选

格式：yyyy-MM-dd HH:mm:ss

userLimit

integer

部门人数限定

必需

-1代表不限定人数

示例

{
    "code": 0,
    "message": "success",
    "data": [
        {
            "id": 20564,
            "name": "凌-merry",
            "parentId": 3765,
            "qwId": 73,
            "qwParentId": 1,
            "createTime": "2022-02-24 14:42:16",
            "updateTime": "2023-03-24 13:09:00",
            "userLimit": 10
        },
        {
            "id": 18672,
            "name": "凌_2_凌英姿***（勿动，勿移人）",
            "parentId": 3765,
            "qwId": 17,
            "qwParentId": 1,
            "createTime": "2022-09-06 17:42:03",
            "updateTime": "2022-08-12 20:15:59",
            "userLimit": -1
        },
        {
            "id": 20209,
            "name": "zyn-2",
            "parentId": 18699,
            "qwId": 347,
            "qwParentId": 96,
            "createTime": "2022-09-06 17:42:03",
            "updateTime": "2022-08-12 20:16:04",
            "userLimit": -1
        },
        {
            "id": 20621,
            "name": "ggg",
            "parentId": 18811,
            "qwId": 393,
            "qwParentId": 221,
            "createTime": "2022-12-08 15:41:59",
            "updateTime": "2022-12-08 15:41:59",
            "userLimit": -1
        },
        {
            "id": 18712,
            "name": "33",
            "parentId": 18633,
            "qwId": 162,
            "qwParentId": 161,
            "createTime": "2022-02-24 14:42:20",
            "updateTime": "2022-08-12 20:16:02",
            "userLimit": -1
        },
        {
            "id": 18811,
            "name": "eee",
            "parentId": 18800,
            "qwId": 221,
            "qwParentId": 220,
            "createTime": "2022-02-24 14:42:28",
            "updateTime": "2022-08-12 20:16:04",
            "userLimit": -1
        }
    ]
}

🟠400参数校验