1. 班组管理

班组管理

1.1. 分页查询班组

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
name string 否 班组名称 支持模糊查询
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
  "pageNum":1,
  "pageSize":2
}

返回数据

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 是 班组名称

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "name": "1111",
                "uuid": "fbd114040c494ff99863e3336cf03769"
            },
            {
                "name": "121",
                "uuid": "f5b5f734fc3543afbb6e3842f8d16afa"
            }
        ],
        "pageNum": 1,
        "pageSize": 2,
        "total": 5
    },
    "msg": "成功"
}

1.2. 添加班组

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
name string 是 班组名称，唯一，长度1~32字符，不支持特殊字符

Body示例:

{
  "name": "testwy"
}

返回数据

Headers:

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

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─uuid string 否 考勤组open ID，添加成功时必有

响应示例:

{
    "code":0,
    "data":{
        "uuid":"95770ead06d640d2983eaa4f8cd8a690"
    },
    "msg":"成功"
}

1.3. 修改班组

基础信息

路径: /v1/api/attendance/group/update

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 是 班组主键UUID
name string 是 班组名称，唯一，长度1~32字符，不支持特殊字符

Body示例:

{
  "name": "testwy123",
  "uuid": "95770ead06d640d2983eaa4f8cd8a690"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.4. 删除班组

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
uuid string 是 班组UUID

Body示例:

{
  "uuid":"fbd114040c494ff99863e3336cf03769"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.5. 分页列表查询班组内的员工

基础信息

路径: /v1/api/attendance/group/person/page

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
groupUuid string 是 班组uuid
personName string 否 员工名称，支持模糊查询
personCode string 否 员工编号，支持模糊查询
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
  "groupUuid": "a0ddbd2440a14564bc79c34bd5381e92",
  "pageNum": 1,
  "pageSize": 2
}

返回数据

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
      |─groupUuid string 否 班组UUID，注：班组基础人员必有
      |─groupName string 否 班组名称，注：班组基础人员必有
      |─personUuid string 是 基础人员UUID
      |─imageUrl string 否 底库照片
      |─personName string 是 基础人员姓名
      |─personCode string 否 基础人员编号
      |─orgUuid string 否 所属机构open ID
      |─orgName string 否 部门名称
      |─phone string 否 手机号

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "groupUuid": "a0ddbd2440a14564bc79c34bd5381e92",
                "imageUrl": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vd3Vrb25n-6c5bc3fd4978976053205133d7583ba8.jpg",
                "orgName": "默认部门",
                "orgUuid": "0",
                "personCode": "13026100668",
                "personName": "xiongzichao",
                "personUuid": "6ce6866601cf46ac859beb17f552aa67",
                "phone": "F71C7DF5E8CF0A513FAD10DD8A83979D"
            },
            {
                "groupUuid": "a0ddbd2440a14564bc79c34bd5381e92",
                "imageUrl": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vd3Vrb25n-322d803bf539ce07ff2c0338fe041c50.jpg",
                "orgName": "默认部门",
                "orgUuid": "0",
                "personCode": "lzx001",
                "personName": "LZX",
                "personUuid": "767de8016eb24a299d8d86f8c6905e69",
                "phone": "C3979DC15B66057E81EB0BB387287D10"
            }
        ],
        "pageNum": 1,
        "pageSize": 2,
        "total": 5
    },
    "msg": "成功"
}

1.6. 全量编辑班组内人员

基础信息

路径: /v1/api/attendance/group/updateGroupPersonRelation

说明: 使用这个接口时，需要先查出来班组内的人员，再新增

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
groupUuid string 是 组UUID
personUuidList array 是 人员UUID列表
  |─ string

Body示例:

{
  "groupUuid": "a0ddbd2440a14564bc79c34bd5381e92",
  "personUuidList": [
    "6ce6866601cf46ac859beb17f552aa67",
    "767de8016eb24a299d8d86f8c6905e69",
    "859166951512449ebe475c014a1469e3",
    "abe3afc1c8864e0f9ee704129415af9c",
    "dfcc5edce8dd44539123a2bf578950a1"
  ]
}

返回数据

Headers:

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

Body:

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

响应示例:

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

1.7. 从班组内移除一批人员

基础信息

路径: /v1/api/attendance/group/deletePersonList

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
groupUuid string 是 组UUID
personUuidList array 是 人员UUID列表
  |─ string

Body示例:

{
  "personUuidList": [
    "dfcc5edce8dd44539123a2bf578950a1",
    "859166951512449ebe475c014a1469e3"
  ],
  "groupUuid": "a0ddbd2440a14564bc79c34bd5381e92"
}

返回数据

Headers:

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

Body:

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

响应示例:

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

results matching ""

    No results matching ""