API docsAPI docs
  • English
  • zh-CN
  • English
  • zh-CN
    • 概述
    • 请求 & 响应
    • 获取Auth Token
    • 使用 Auth Token
    • Api Example
    • 区域API
    • 部门API
    • 职位API
    • 人员API
    • 离职API
    • 设备API
    • 考勤记录API
    • 考勤报表API

职位API

列表

请求

  • Method: GET

  • Url: /personnel/api/positions/

  • Headers:

    • Content-Type: application/json
    • Authorization: "JWT ey.........oQi98"
  • Query Parameters

参数描述
page显示第几页
page_size显示该页数据的条数
position_code使用该字段进行查询
position_name使用该字段进行查询
position_code_icontains查询该字段包含所填内容的数据
position_name_icontains查询该字段包含所填内容的数据
ordering按id, position_code, position_name进行排序

响应

{
    "count": 27,
    "next": "null",
    "previous": null,
    "msg": "",
    "code": 0,
    "data": [
        {
            "id": 1,
            "position_code": "1",
            "position_name": "WORLD",
            "parent_position": null
        },
        {
            "id": 93,
            "position_code": "5190062",
            "position_name": "shenzhen",
            "parent_position": null
        },
        ...
        ...
}

读取

请求

  • Method: GET

  • Url: /personnel/api/positions/{id}/

  • Headers:

    • Content-Type: application/json
    • Authorization: "JWT ey.........oQi98"
  • Path Parameters

参数描述
id必填

响应

- **Url:** /personnel/api/positions/1/
{
    "id": 1,
    "position_code": "1",
    "position_name": "WORLD",
    "parent_position": null
}

创建

  • Method: POST
  • Url: /personnel/api/positions/
  • Headers:
    • Content-Type: application/json
    • Authorization: "JWT ey.........oQi98"
  • Request Body
{
    "position_code": "test position code",
    "position_name": "test position name",
    "parent_position": null
}
参数必填类型描述
position_codeYString职位编号
position_nameYString职位名称
parent_positionNInteger上级职位

响应

{
    "id": 100,
    "position_code": "test position code",
    "position_name": "test position name",
    "parent_position": null
}

Update

请求

  • Method: PUT

  • Url: /personnel/api/positions/{id}/

  • Headers:

    • Content-Type: application/json
    • Authorization: "JWT ey.........oQi98"
  • Path Parameters

参数描述
id必填
  • Request Body
{
    "position_code": "11",
    "position_name": "test position name",
}
参数必填类型描述
position_codeYString职位编号
position_nameYString职位名称
parent_positionNInteger上级职位

响应

- **Url:** PUT /personnel/api/positions/1/
{
    "id": 1,
    "position_code": "11",
    "position_name": "WORLD WORLD",
    "parent_position": null
}

删除

请求

  • Method: DELETE

  • Url: /personnel/api/positions/{id}/

  • Headers:

    • Content-Type: application/json
    • Authorization: "JWT ey.........oQi98"
  • Path Parameters

参数描述
id必填

响应

None
Prev
部门API
Next
人员API