获取企业职务列表新版SDK

更新于 2024-03-19调用本接口，分页查询企业的职务相关信息，包括职务的ID、职务名称和职务描述等信息。

智能人事需要升级职位管理功能。

说明

智能人事升级职位管理功能后，需注意以下：

调用通讯录更新用户信息V1接口和更新用户信息V2接口更新员工部门或者员工职位时，接口会出现报错，报错信息如下图所示。如果需要更新员工部门或者员工职位，请参考使用智能人事员工调岗接口。

例如，在钉钉工作台 > 智能人事 > 人事 > 职位管理 > 职务管理页面，职务列表中有个名为测试职务1的职务。

测试职务1的职务名称为测试职务1，职务描述为测试职务1。调用本接口可获取测试职务1的职务名称、职务描述等信息，如下图所示。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	智能人事个人信息读权限	API Explorer
第三方企业应用	支持	智能人事个人信息读权限	API Explorer

名称	类型	是否必填	描述
x-acs-dingtalk-access-token	String	是	调用该接口的访问凭证。企业内部应用，调用获取企业内部应用的accessToken接口获取。第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

名称	类型	是否必填	描述
jobName	String	否	职务名称。首次查询：需先调用本接口获取jobName。非首次查询：从首次查询中的信息获取需要的jobName值。说明该参数为非必填参数。
nextToken	Integer	是	分页游标。首次调用，该参数传0。非首次调用，该参数传上次调用本接口返回的nextToken。
maxResults	Integer	是	每页最大条目数，最大值100。

名称

类型

是否必填

描述

jobName

String

否

职务名称。

说明

该参数为非必填参数。

nextToken

Integer

是

分页游标。

maxResults

Integer

是

每页最大条目数，最大值100。