获取职位列表

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/position/external/list
Query参数说明：

参数	类型	必须	说明
access_token	String	是	应用access_token，2小时有效期
page	Int	否	页码，默认从1开始
page_size	Int	否	每页条数，最大100，默认100

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "position_id": "43A844CA-55F0-4EE0-A056-EFFF58AB8E83",
                "position": "测试002",
                "create_time": 1744356112000,
                "update_time": 1744356134000
            },
            {
                "position_id": "54B532FD-6088-4B17-8C43-8DE225BA5DB9",
                "position": "测试002",
                "create_time": 1742318991000,
                "update_time": 1742318994000
            }
        ],
        "has_more": 1
    }
}

参数说明：

参数	类型	说明
data	Array	返回的数据包
list	Array	返回的用户列表
position_id	String	职位ID，最大长度36字符
position	String	职位名称，最大长度255字符
create_time	Bigint	创建时间，Unix时间戳，单位毫秒
update_time	Bigint	创建时间，Unix时间戳，单位毫秒
has_more	Int	是否还有数据没返回： 1 还有 0 没有

获取职位详情

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/position/external/info
Query参数说明：

参数	类型	必须	说明
access_token	String	是	应用access_token，2小时有效期
position_id	String	是	职位ID

返回结果：

{
  "code": "200",
  "status": "ok",
  "message": "success",
  "data": 
    {
        "position_id": "54B532FD-6088-4B17-8C43-8DE225BA5DB9",
        "position": "测试001",
        "create_time": 1742318991000,
        "update_time": 1742318994000
    }
}

参数说明：

参数	类型	说明
data	Array	返回的数据包
position_id	String	职位ID，最大长度36字符
position	String	职位名称，最大长度255字符
create_time	Bigint	创建时间，Unix时间戳，单位毫秒
update_time	Bigint	创建时间，Unix时间戳，单位毫秒

创建职位

请求方式：POST（HTTPS）
请求地址：https://oapi.soke.cn/position/external/create
Query参数说明：

参数	类型	必须	说明
access_token	String	是	应用access_token，2小时有效期
position	String	是	职位名称

成功返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "position_id": "43A844CA-55F0-4EE0-A056-EFFF58AB8E83"
    }
}

职位修改

请求方式：POST（HTTPS）
请求地址：https://oapi.soke.cn/position/external/update
Query参数说明：

参数	类型	必须	说明
access_token	String	是	应用access_token，2小时有效期
position	String	是	新职位名称 （新名称已存在无法修改）
position_id	String	是	职位ID （职位已经被职位组引用无法修改）

成功返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": []
}

职位删除

请求方式：POST（HTTPS）
请求地址：https://oapi.soke.cn/position/external/delete
Query参数说明：

参数	类型	必须	说明
access_token	String	是	应用access_token，2小时有效期
position_id	String	是	职位ID （职位已经被职位组引用无法删除）

成功返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": []
}