获取职务列表

权限

身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。

权限代码	描述
job_title_all	职务管理接口的读写权限
job_title_read	职务管理接口的读权限
all	全部接口读写权限
read	所有读接口的权限

请求说明

GET https://{your_domain}/api/v2/tenant/job-titles?offset=0&limit=10&updated_at_greater=

请求头

参数名	中文名称	必须	类型	描述
Authorization	授权	是	String	格式：Bearer {access_token}
Content-Type	内容类型	是	String	固定值：application/json; charset=utf-8

请求示例

无

请求参数

参数名	中文名称	必须	类型	描述
updated_at_greater	更新时间大于	否	String	根据更新时间过滤，更新时间在此之后的才会返回，格式为 yyyy-MM-dd HH:mm:ss
offset	分页页码	是	int	从第0页开始
limit	每页数量	是	int	每页数量在10-100之间

返回示例

正确示例：
HTTP/1.1 200 OK
Content-Type: application/json
{
    "total": 1,
    "job_titles": [
        {
            "title_id": "20220825141325371-4D03-81EF80243",
            "name": "高级工程师",
            "code": "Senior_Engineer",
            "created_at": "2024-03-27 10:00:45.532",
            "updated_at": "2024-03-28 08:26:00.105"
        }
    ]
}


错误示例：
HTTP/1.1 400 Bad Request
{
  "error_msg": "分页参数错误",
  "error_code": "OAP.PAGE.0001"
}

返回参数

参数名	中文名称	类型	描述
total	总数	int
job_titles	职务集合	List
--title_id	职务ID	String
--name	职位名称	String
--code	职位编码	String
--created_at	创建时间	String
--updated_at	修改时间	String

错误码

状态码	错误码	错误信息	处理措施
400	ENT.CONFIG.0031	任职管理功能未开启，请先开启此功能	请先在企业中心开启任职管理
		The job management function is not enabled, please enable this function first
400	OAP.PAGE.0003	分页页码不符合校验规则	请检查入参分页页码是否正确
		The pagination page number does not meet the verification rules
400	OAP.PAGE.0004	每页数量不符合校验规则	请检查入参每页数量是否正确
		The number of pages does not meet the verification rules
400	OAP.PARAM.0004	参数[{0}]不符合校验规则	请检查入参是否符合校验规则
		Parameter [{0}] does not comply with validation rules