获取在职员工列表

POST

/topapi/smartwork/hrm/employee/queryonjob

调用本接口，查询企业在职员工userid列表。

重要

该接口只能获取企业开通“智能人事”应用之后的员工信息，获取不到开通之前的员工信息。

针对家校企业、关联组织，本接口不保证和智能人事产品上数据一致，请直接使用通讯录接口获取企业内员工。

调用本接口，可获取在职员工列表。接口调用效果与下图操作实现效果一致。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/queryonjob?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
        "status_list":"2,3,5,-1",
        "size":"50",
        "offset":"0"
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "result": {
        "data_list": [
            "user123"
        ],
        "next_cursor": 0,
    },
    "success": true,
    "request_id": "u2nu5vpoq6p4"
}

修改于 2024-01-11 06:42:07

添加待入职员工

获取离职员工列表

获取在职员工列表

权限#

请求参数

返回响应

权限