对外公开接口

对外公开接口


考勤结果

<h1>智慧园区管理平台</h1> <blockquote> <p>v1.0.0</p> </blockquote> <h1>基础服务/考勤结果</h1> <p><strong>简要描述:</strong></p> <ul> <li>考勤结果分页</li> </ul> <p><strong>请求URL:</strong></p> <ul> <li><a href="http://58.56.128.186:10148/qrqdSafe/attendance/result/page">http://58.56.128.186:10148/qrqdSafe/attendance/result/page</a></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>GET</li> </ul> <p><strong>鉴权:</strong></p> <ul> <li>AppSecret:d21e6d67cc1a13d22a65bed4eb46100b</li> </ul> <p><strong>请求示例截图:</strong></p> <p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=3229d697f51b84f5002437f8dcb34db7&amp;file=file.png" alt="" /></p> <h3>请求参数</h3> <table> <thead> <tr> <th>名称</th> <th>位置</th> <th>类型</th> <th>必选</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>personName</td> <td>query</td> <td>string</td> <td>否</td> <td>人员名称 (模糊查询)</td> </tr> <tr> <td>empno</td> <td>query</td> <td>string</td> <td>否</td> <td>员工号</td> </tr> <tr> <td>deptId</td> <td>query</td> <td>integer</td> <td>否</td> <td>部门 id (查询结果为本级及子集)</td> </tr> <tr> <td>startDate</td> <td>query</td> <td>string</td> <td>否</td> <td>开始时间 (yyyy-MM-dd)</td> </tr> <tr> <td>endDate</td> <td>query</td> <td>string</td> <td>否</td> <td>结束时间 (yyyy-MM-dd)</td> </tr> <tr> <td>page</td> <td>query</td> <td>string</td> <td>是</td> <td>页数</td> </tr> <tr> <td>limit</td> <td>query</td> <td>string</td> <td>是</td> <td>每页条数</td> </tr> <tr> <td>AppSecret</td> <td>header</td> <td>string</td> <td>是</td> <td>权限 secret</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>http://58.56.128.186:10148/qrqdSafe/attendance/result/page?startDate=2022-10-20&amp;endDate=2022-10-21</code></pre> <h5>返回示例</h5> <pre><code>{ "msg": "success", "code": 0, "data": { "total": 21, "size": 10, "current": 1, "records": [ { "delFlag": "0", "remark": null, "createTime": "2022-10-21 12:00:01", "updateTime": "2022-10-21 18:00:01", "createBy": null, "updateBy": null, "recordId": "5105685bb16e3d0e7205e68e08e5c83b", "projectId": 242, "tenantId": 114, "personId": "149", "personName": "张炜聪", "organizationId": "124", "organizationName": "默认组织/奇瑞股份有限公司/青岛分公司/总经理", "groupId": "1e7bdf87d1a671f15b5c5c2726e007b2", "groupName": "奇瑞班组", "shiftId": "c7c96138-1e12-450a-a293-87a8f607973c", "shiftName": "上班下班班次", "onDutyDate": "2022-10-21", "timePeriodNo": 1, "onTime": "14:00:00", "clockOnTimeIso": null, "onStatus": 22, "onStatusStr": "Absent", "onStatusName": null, "minuteLate": 0, "acReaderNameOn": "考勤机_门_1_读卡器_1", "doorNameOn": null, "controllerNameOn": null, "cardNumOn": null, "offTime": "17:00:00", "clockOffTimeIso": null, "offStatus": 22, "offStatusStr": "Absent", "offStatusName": null, "minuteEarly": 61, "acReaderNameOff": "考勤机_门_1_读卡器_1", "doorNameOff": null, "controllerNameOff": null, "cardNumOff": null, "minLeave": 0, "minCompLeave": 0, "minOvertime": 0, "minAttend": 0, "timeAll": 145, "lessTime": 0, "deptId": null, "empno": null, "startDate": null, "endDate": null, "userIds": [], "deptIds": [], "startTime": null, "endTime": null }, { "delFlag": "0", "remark": null, "createTime": "2022-10-21 12:00:01", "updateTime": "2022-10-21 12:00:01", "createBy": null, "updateBy": null, "recordId": "68a816d050058eca0a47d5156ec458c6", "projectId": 242, "tenantId": 114, "personId": "150", "personName": "陈浩", "organizationId": "162", "organizationName": "默认组织/奇瑞股份有限公司/青岛分公司/制造部/涂装车间/涂装技术组", "groupId": "1e7bdf87d1a671f15b5c5c2726e007b2", "groupName": "奇瑞班组", "shiftId": "c7c96138-1e12-450a-a293-87a8f607973c", "shiftName": "上班下班班次", "onDutyDate": "2022-10-21", "timePeriodNo": 1, "onTime": "14:00:00", "clockOnTimeIso": null, "onStatus": 22, "onStatusStr": "Absent", "onStatusName": null, "minuteLate": 0, "acReaderNameOn": null, "doorNameOn": null, "controllerNameOn": null, "cardNumOn": null, "offTime": "17:00:00", "clockOffTimeIso": null, "offStatus": 22, "offStatusStr": "Absent", "offStatusName": null, "minuteEarly": 0, "acReaderNameOff": null, "doorNameOff": null, "controllerNameOff": null, "cardNumOff": null, "minLeave": 0, "minCompLeave": 0, "minOvertime": 0, "minAttend": 0, "timeAll": 145, "lessTime": 145, "deptId": null, "empno": null, "startDate": null, "endDate": null, "userIds": [], "deptIds": [], "startTime": null, "endTime": null } ], "pages": 3 } } </code></pre> <h3>返回数据结构</h3> <p>状态码 <strong>200</strong></p> <table> <thead> <tr> <th>名称</th> <th>类型</th> <th>必选</th> <th>约束</th> <th>中文名</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>» msg</td> <td>string</td> <td>true</td> <td>none</td> <td>返回信息</td> <td>none</td> </tr> <tr> <td>» code</td> <td>integer</td> <td>true</td> <td>none</td> <td>返回编码</td> <td>none</td> </tr> <tr> <td>» data</td> <td>object</td> <td>true</td> <td>none</td> <td>返回数据</td> <td>none</td> </tr> <tr> <td>»» total</td> <td>integer</td> <td>true</td> <td>none</td> <td>总数</td> <td>none</td> </tr> <tr> <td>»» size</td> <td>integer</td> <td>true</td> <td>none</td> <td>每页显示条数</td> <td>none</td> </tr> <tr> <td>»» current</td> <td>integer</td> <td>true</td> <td>none</td> <td>当前页</td> <td>none</td> </tr> <tr> <td>»» records</td> <td>[object]</td> <td>true</td> <td>none</td> <td>查询数据列表</td> <td>none</td> </tr> <tr> <td>»»» delFlag</td> <td>string</td> <td>true</td> <td>none</td> <td>删除标识 0-正常,1-删除</td> <td>none</td> </tr> <tr> <td>»»» remark</td> <td>null</td> <td>true</td> <td>none</td> <td>备注,描述</td> <td>none</td> </tr> <tr> <td>»»» createTime</td> <td>string</td> <td>true</td> <td>none</td> <td>创建时间</td> <td>none</td> </tr> <tr> <td>»»» updateTime</td> <td>string</td> <td>true</td> <td>none</td> <td>修改时间</td> <td>none</td> </tr> <tr> <td>»»» createBy</td> <td>null</td> <td>true</td> <td>none</td> <td>创建人 ID</td> <td>none</td> </tr> <tr> <td>»»» updateBy</td> <td>null</td> <td>true</td> <td>none</td> <td>修改人 ID</td> <td>none</td> </tr> <tr> <td>»»» recordId</td> <td>string</td> <td>true</td> <td>none</td> <td>考勤记录唯一标识</td> <td>none</td> </tr> <tr> <td>»»» projectId</td> <td>integer</td> <td>true</td> <td>none</td> <td>项目 id</td> <td>none</td> </tr> <tr> <td>»»» tenantId</td> <td>integer</td> <td>true</td> <td>none</td> <td>租户 id</td> <td>none</td> </tr> <tr> <td>»»» personId</td> <td>string</td> <td>true</td> <td>none</td> <td>人员Id</td> <td>none</td> </tr> <tr> <td>»»» personName</td> <td>string</td> <td>true</td> <td>none</td> <td>人员名称</td> <td>none</td> </tr> <tr> <td>»»» organizationId</td> <td>string</td> <td>true</td> <td>none</td> <td>组织id</td> <td>none</td> </tr> <tr> <td>»»» organizationName</td> <td>string</td> <td>true</td> <td>none</td> <td>组织名称</td> <td>none</td> </tr> <tr> <td>»»» groupId</td> <td>string</td> <td>true</td> <td>none</td> <td>班组ID</td> <td>none</td> </tr> <tr> <td>»»» groupName</td> <td>string</td> <td>true</td> <td>none</td> <td>班组名称</td> <td>none</td> </tr> <tr> <td>»»» shiftId</td> <td>string</td> <td>true</td> <td>none</td> <td>班次ID</td> <td>none</td> </tr> <tr> <td>»»» shiftName</td> <td>string</td> <td>true</td> <td>none</td> <td>班次名称</td> <td>none</td> </tr> <tr> <td>»»» onDutyDate</td> <td>string</td> <td>true</td> <td>none</td> <td>考勤日期</td> <td>none</td> </tr> <tr> <td>»»» timePeriodNo</td> <td>Integer</td> <td>true</td> <td>none</td> <td>时段号</td> <td>none</td> </tr> <tr> <td>»»» onTime</td> <td>string</td> <td>true</td> <td>none</td> <td>上班时间</td> <td>none</td> </tr> <tr> <td>»»» clockOnTimeIso</td> <td>string</td> <td>true</td> <td>none</td> <td>上班刷卡ISO时间</td> <td>none</td> </tr> <tr> <td>»»» onStatus</td> <td>string</td> <td>true</td> <td>none</td> <td>上班状态</td> <td>none</td> </tr> <tr> <td>»»» onStatusStr</td> <td>string</td> <td>true</td> <td>none</td> <td>上班状态名称</td> <td>none</td> </tr> <tr> <td>»»» onStatusName</td> <td>string</td> <td>true</td> <td>none</td> <td>上班状态具体调整原因</td> <td>none</td> </tr> <tr> <td>»»» minuteLate</td> <td>Integer</td> <td>true</td> <td>none</td> <td>迟到时长(分钟)</td> <td>none</td> </tr> <tr> <td>»»» acReaderNameOn</td> <td>string</td> <td>true</td> <td>none</td> <td>班次名称</td> <td>none</td> </tr> <tr> <td>»»» doorNameOn</td> <td>string</td> <td>true</td> <td>none</td> <td>上班刷卡门名称</td> <td>none</td> </tr> <tr> <td>»»» controllerNameOn</td> <td>string</td> <td>true</td> <td>none</td> <td>上班控制器名称</td> <td>none</td> </tr> <tr> <td>»»» cardNumOn</td> <td>string</td> <td>true</td> <td>none</td> <td>上班刷卡卡号</td> <td>none</td> </tr> <tr> <td>»»» offTime</td> <td>string</td> <td>true</td> <td>none</td> <td>下班时间</td> <td>none</td> </tr> <tr> <td>»»» clockOffTimeIso</td> <td>string</td> <td>true</td> <td>none</td> <td>下班刷卡ISO时间</td> <td>none</td> </tr> <tr> <td>»»» offStatus</td> <td>string</td> <td>true</td> <td>none</td> <td>下班刷卡状态</td> <td>none</td> </tr> <tr> <td>»»» offStatusStr</td> <td>string</td> <td>true</td> <td>none</td> <td>下班状态</td> <td>none</td> </tr> <tr> <td>»»» offStatusName</td> <td>string</td> <td>true</td> <td>none</td> <td>下班状态具体调整原因</td> <td>none</td> </tr> <tr> <td>»»» minuteEarly</td> <td>Integer</td> <td>true</td> <td>none</td> <td>早退时长(分钟)</td> <td>none</td> </tr> <tr> <td>»»» acReaderNameOff</td> <td>string</td> <td>true</td> <td>none</td> <td>下班读头名称</td> <td>none</td> </tr> <tr> <td>»»» doorNameOff</td> <td>string</td> <td>true</td> <td>none</td> <td>下班门名称</td> <td>none</td> </tr> <tr> <td>»»» controllerNameOff</td> <td>string</td> <td>true</td> <td>none</td> <td>下班控制器名称</td> <td>none</td> </tr> <tr> <td>»»» cardNumOff</td> <td>string</td> <td>true</td> <td>none</td> <td>下班刷卡卡号</td> <td>none</td> </tr> <tr> <td>»»» minLeave</td> <td>Integer</td> <td>true</td> <td>none</td> <td>请假时长(分钟)</td> <td>none</td> </tr> <tr> <td>»»» minCompLeave</td> <td>Integer</td> <td>true</td> <td>none</td> <td>调休时长(分钟)</td> <td>none</td> </tr> <tr> <td>»»» minOvertime</td> <td>Integer</td> <td>true</td> <td>none</td> <td>加班时长(分钟)</td> <td>none</td> </tr> <tr> <td>»»» minAttend</td> <td>Integer</td> <td>true</td> <td>none</td> <td>出勤时长(分钟)</td> <td>none</td> </tr> <tr> <td>»»» timeAll</td> <td>Integer</td> <td>true</td> <td>none</td> <td>应上工时(分钟)</td> <td>none</td> </tr> <tr> <td>»»» lessTime</td> <td>Integer</td> <td>true</td> <td>none</td> <td>不足工时(分钟)</td> <td>none</td> </tr> <tr> <td>»»» cardNumOn</td> <td>Integer</td> <td>true</td> <td>none</td> <td>上班刷卡卡号</td> <td>none</td> </tr> <tr> <td>»» pages</td> <td>integer</td> <td>true</td> <td>none</td> <td>总页数</td> <td>none</td> </tr> </tbody> </table>

页面列表

ITEM_HTML