1. 考勤点管理
考勤点管理
1.1. 查询考勤设备类型
基础信息
路径: /v1/api/attendance/device/type
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | array | 否 | 具体的返回值 | |
|─ | object | |||
|─sysDictTypeId | integer | 否 | ||
|─label | string | 否 | name | |
|─value | integer | 否 | value |
响应示例:
{
"code": 0,
"data": [
{
"label": "智能摄像头",
"sysDictTypeId": 11,
"value": 1
},
{
"label": "智能面板机",
"sysDictTypeId": 11,
"value": 2
},
{
"label": "网络摄像机",
"sysDictTypeId": 11,
"value": 4
},
{
"label": "门禁控制器",
"sysDictTypeId": 11,
"value": 6
},
{
"label": "智能边缘服务器",
"sysDictTypeId": 11,
"value": 7
}
],
"msg": "成功"
}
1.2. 分页查询未添加考勤点的门禁点
基础信息
路径: /v1/api/attendance/point/device/list
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
pointName | string | 否 | 门禁点名称 | |
pointLocation | string | 否 | 门禁点位置 | |
zoneUuid | string | 否 | 区域uuid | |
deviceTypes | array | 否 | 设备类型 | |
|─ | integer | |||
deviceModelUuid | string | 否 | 设备型号uuid | |
pageNum | integer | 否 | 1 | 页码,从1开始 当前页码,不传默认1 |
pageSize | integer | 否 | 20 | 页面大小 分页大小,不传默认20 |
Body示例:
{
"pageNum": 1,
"pageSize": 10
}
返回数据
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 | |||
|─pointUuid | string | 否 | 门禁点UUID | |
|─pointName | string | 否 | 门禁点名称 | |
|─pointLocation | string | 否 | 门禁点位置 | |
|─zoneUuid | string | 否 | 区域uuid | |
|─zoneName | string | 否 | 区域名称 | |
|─deviceType | integer | 否 | 设备类型: 1-智能摄像头、2-智能面板机、4-网络摄像机 | |
|─deviceTypeName | string | 否 | 设备类型名称 | |
|─deviceModel | integer | 否 | 设备型号CODE | |
|─deviceModelName | string | 否 | 设备型号名称 |
响应示例:
{
"code":0,
"data":{
"list":[
{
"deviceModel":65,
"deviceModelName":"MegEye-C4H-240-P",
"deviceType":1,
"deviceTypeName":"智能摄像头",
"pointLocation":"WH",
"pointName":"LZX_门禁1",
"pointUuid":"1c48f5673de9494e85553e1ff25c9345",
"zoneName":"默认区域",
"zoneUuid":"0"
}
],
"pageNum":1,
"pageSize":10,
"total":1
},
"msg":"成功"
}
1.3. 分页查询考勤点
基础信息
路径: /v1/api/attendance/point/page
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
attendancePointName | string | 否 | 考勤点名称 | |
zoneUuid | string | 否 | 区域uuid | |
attendanceType | integer | 否 | 考勤点类型,1:进门考勤点;2:出门考勤点;3:进出门考勤点 | |
pointName | string | 否 | 门禁点名称 | |
pointLocation | string | 否 | 门禁点位置 | |
deviceTypes | array | 否 | 设备类型 | |
|─ | integer | |||
deviceModelUuid | string | 否 | 设备型号uuid | |
pointUuid | string | 否 | 门禁点uuid | |
pageNum | integer | 否 | 1 | 页码,从1开始 当前页码,不传默认1 |
pageSize | integer | 否 | 20 | 页面大小 分页大小,不传默认20 |
Body示例:
{
"pageNum": 1,
"pageSize": 10
}
返回数据
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 | |||
|─attendancePointUuid | string | 否 | 考勤点uuid | |
|─attendancePointName | string | 否 | 考勤点名称 | |
|─zoneUuid | string | 否 | 区域uuid | |
|─zoneName | string | 否 | 区域名称 | |
|─attendanceType | integer | 否 | 考勤点类型,1:上班考勤点;2:下班考勤点;3:上下班考勤点 | |
|─attendanceTypeName | string | 否 | 考勤点类型名称 | |
|─pointName | string | 否 | 门禁点名称 | |
|─pointLocation | string | 否 | 门禁点位置 | |
|─deviceType | integer | 否 | 设备类型: 1-智能摄像头、2-智能面板机、4-网络摄像机、6-门禁控制器、7-智能边缘服务器 | |
|─deviceTypeName | string | 否 | 设备类型名称 | |
|─deviceModel | integer | 否 | 设备型号CODE | |
|─deviceModelName | string | 否 | 设备型号名称 | |
|─computerChannelNo | integer | 否 | 通道号 |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"attendancePointName": "C4H-数据拉取门禁点",
"attendancePointUuid": "7cab62e67e8b4b78801e4f6c345d4a47",
"attendanceType": 1,
"attendanceTypeName": "上班考勤点",
"computerChannelNo": 1,
"deviceModel": 65,
"deviceModelName": "MegEye-C4H-240-P",
"deviceType": 1,
"deviceTypeName": "智能摄像头",
"pointLocation": "111111",
"pointName": "C4H-数据拉取门禁点",
"zoneName": "默认区域",
"zoneUuid": "0"
},
{
"attendancePointName": "W5K-0056-ZL",
"attendancePointUuid": "dcc49e2dc46b4b7296f9938b2d367bb9",
"attendanceType": 1,
"attendanceTypeName": "上班考勤点",
"computerChannelNo": 1,
"deviceModel": 1,
"deviceModelName": "MegEye-W5K-I8",
"deviceType": 2,
"deviceTypeName": "智能面板机",
"pointLocation": "",
"pointName": "W5K-0056-ZL",
"zoneName": "面板机",
"zoneUuid": "ba29ab4aed79441aa9d6a97dc786925f"
}
],
"pageNum": 1,
"pageSize": 10,
"total": 2
},
"msg": "成功"
}
1.4. 批量添加考勤点
基础信息
路径: /v1/api/attendance/point/batchAdd
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
uuids | array | 是 | 要添加的门禁点UUID列表 | |
|─ | string | |||
attendanceType | integer | 是 | 考勤点类型,1:进门考勤点;2:出门考勤点;3:进出门考勤点 |
Body示例:
{
"uuids": [
"1c48f5673de9494e85553e1ff25c9345"
],
"attendanceType": 1
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 |
响应示例:
{
"code":0,
"msg":"成功"
}
1.5. 批量删除考勤点
基础信息
路径: /v1/api/attendance/point/batchDelete
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
uuids | array | 是 | 要删除的考勤点UUID列表 | |
|─ | string |
Body示例:
{
"uuids": [
"0cdd725d5355464d8b5b9c32a3feafb5"
]
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 |
响应示例:
{
"code":0,
"msg":"成功"
}
1.6. 编辑考勤点
基础信息
路径: /v1/api/attendance/point/modify
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
uuid | string | 是 | 考勤点uuid | |
name | string | 是 | 考勤点名称 | |
type | integer | 是 | 考勤点类型,1:进门考勤点;2:出门考勤点;3:进出门考勤点 |
Body示例:
{
"uuid": "7cab62e67e8b4b78801e4f6c345d4a47",
"name": "C4H-数据拉取门禁点",
"type": 1
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 |
响应示例:
{
"code": 0,
"msg": "成功"
}
1.7. 查询单个考勤点
基础信息
路径: /v1/api/attendance/point/selectOne
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
pointUuid | string | 是 | 门禁点uuid |
Body示例:
{
"pointUuid":"7cab62e67e8b4b78801e4f6c345d4a47"
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─attendancePointUuid | string | 否 | 考勤点uuid | |
|─attendancePointName | string | 否 | 考勤点名称 | |
|─zoneUuid | string | 否 | 区域uuid | |
|─zoneName | string | 否 | 区域名称 | |
|─attendanceType | integer | 否 | 考勤点类型,1:进门考勤点;2:出门考勤点;3:进出门考勤点 | |
|─attendanceTypeName | string | 否 | 考勤点类型名称 | |
|─pointName | string | 否 | 门禁点 | |
|─pointLocation | string | 否 | 门禁点位置 | |
|─computerChannelNo | integer | 否 | 通道号 | |
|─deviceType | integer | 否 | 设备类型: 1-智能摄像头、2-智能面板机、4-网络摄像机 | |
|─deviceTypeName | string | 否 | 设备类型名称 | |
|─deviceModel | integer | 否 | 设备型号CODE | |
|─deviceModelName | string | 否 | 设备型号名称 |
响应示例:
{
"code": 0,
"data": {
"attendancePointName": "C4H-数据拉取门禁点",
"attendancePointUuid": "7cab62e67e8b4b78801e4f6c345d4a47",
"attendanceType": 1,
"computerChannelNo": 1,
"deviceModel": 65,
"deviceModelName": "MegEye-C4H-240-P",
"deviceType": 1,
"deviceTypeName": "智能摄像头",
"pointLocation": "111111",
"pointName": "C4H-数据拉取门禁点",
"zoneName": "默认区域",
"zoneUuid": "0"
},
"msg": "成功"
}