1. 节假日管理

节假日管理

1.1. 分页查询节假日

基础信息

路径: /v1/api/attendance/holiday/page

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
name string 否 节假日名称
startTime integer 否 节假日开始日期,毫秒时间戳
endTime integer 否 节假日结束日期,毫秒时间戳
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
  "pageNum": 1,
  "pageSize": 10,
  "startTime": 1687190400000,
  "endTime": 1693497599000
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─pageNum integer 是 页码，从1开始
当前页码
  |─pageSize integer 是 页面大小
分页大小
  |─total integer 是 总记录数
总数
  |─list array 否
    |─ object
      |─uuid string 否 节假日uuid
      |─name string 否 节假日名称
      |─startTime string 否 节假日开始日期,毫秒时间戳
      |─endTime string 否 节假日结束日期,毫秒时间戳
      |─note string 否 备注

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "endTime": 1690300800000,
                "name": "啦啦啦",
                "note": "11212",
                "startTime": 1686153600000,
                "uuid": "e63bc40a575f4ce695b76e4b98667cd4"
            }
        ],
        "pageNum": 1,
        "pageSize": 10,
        "total": 1
    },
    "msg": "成功"
}

1.2. 添加节假日

基础信息

路径: /v1/api/attendance/holiday/add

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
name string 是 节假日名称
startTime integer 是 节假日开始日期,毫秒时间戳
endTime integer 是 节假日结束日期,毫秒时间戳
note string 否 备注

Body示例:

{
  "name": "暑假",
  "startTime": "1685548800000",
  "endTime": "1693497600000",
  "note": "放暑假"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
    "code":0,
    "msg":"成功"
}

1.3. 删除节假日

基础信息

路径: /v1/api/attendance/holiday/delete

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 节假日uuid

Body示例:

{
  "uuid": "99396c63b5e744dea9dcabd54fb9f4bb"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
    "code":0,
    "msg":"成功"
}

1.4. 修改节假日

基础信息

路径: /v1/api/attendance/holiday/modify

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 节假日uuid
name string 是 节假日名称
startTime integer 是 节假日开始日期,毫秒时间戳
endTime integer 是 节假日结束日期,毫秒时间戳
note string 否 备注

Body示例:

{
  "uuid": "e63bc40a575f4ce695b76e4b98667cd4",
  "name": "啦啦啦",
  "startTime": 1686153600000,
  "endTime": 1690300800000,
  "note": "11212"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
    "code":0,
    "msg":"成功"
}

1.5. 查询节假日是否关联有班次

基础信息

路径: /v1/api/attendance/holiday/shift/relation

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
holidayUuid string 是 节假日uuid

Body示例:

{
  "holidayUuid": "7ab43f18b95844a59034bbdc3f8fabb9"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─relationFlag boolean 否 是否关联班次
是否关联班次，true：已关联，false：未关联

响应示例:

{
    "code": 0,
    "data": {
        "relationFlag": true
    },
    "msg": "成功"
}

results matching ""

    No results matching ""