1. 统计人数和考勤人数(岗位)

开放平台2.0-项目-统计人数和考勤人数(岗位)

注意

  • 如果接口需要提供auth-token,你需要通过轻筑开放平台创建应用来获取appid和secret,然后通过appid和secret来获取接口访问凭证auth-token。
  • 如果需要获取当前用户的使用信息,授权确保你能获取到qzcode,然后通过网页授权接口获取相关信息。

1.1. 基本信息

概况 内容
接口地址 /api/open/v2/labor/project/statisticByStation
请求方法 POST
请求数据类型 JSON
响应数据类型 JSON

1.2. 请求数据

1.2.1. 请求头(request-header)

请求头除了默认的参数还需要添加如下请求头参数:

字段 描述
auth-token 接口访问凭据,你可以通过平台下发的appid和secret获取凭据
Content-Type application/json;charset=UTF-8

1.2.2. 请求体(request-body)

字段 类型 是否必填 描述
projectUuid string 项目id
pageNum number 当前页数
pageSize number 每页条数
workingStatus number 在离岗状态 0-全部 1-在岗 2-离岗
date string 日期(yyyy-MM-dd)

1.3. 响应数据

响应数据中 code, message, data 为默认字段,所有字段如下表所示:

字段 类型 是否必填 描述
code number 返回码
msg string 返回信息
data object 返回数据
  total number 总条数
  pages number 总页数
  size number 当前页数量
  isLastPage boolean 是否最后一页
  pageSize number 每页数量
  isFirstPage boolean 是否第一页
  pageNum number 当前页数
  list array 分页数据
        code string 岗位code
        attendanceCount number 出勤人数
        name string 岗位名称
        rosterCount number 人员数量
        rosterList array 人员列表
              name string 人员姓名
              workTimeLength number 考勤时长(秒)
              hasAttendanceRecord number 是否有考勤记录 0-没有 1-有
              uuid string 人员uuid

响应数据结构如下所示:

{
  "code": 0,
  "msg": "成功",
  "data": {
    "total": 45,
    "pages": 5,
    "size": 10,
    "isLastPage": false,
    "pageSize": 10,
    "isFirstPage": true,
    "list": [
      {
        "code": "101",
        "attendanceCount": 1,
        "rosterList": [{
            "name": "xx",
            "workTimeLength": 32122,
            "hasAttendanceRecord": 1,
            "uuid": "xxxxxxxxxxxxxxxxx"
          }],
        "name": "建设方-项目经理",
        "rosterCount": 1
      },
      {
        "code": "102",
        "attendanceCount": 0,
        "rosterList": [],
        "name": "建设方-施工经理",
        "rosterCount": 0
      }
    ],
    "pageNum": 1
  }
}

1.4. 错误码

当返回数据中的 code 不为 0 时,为错误返回。其中errCode为详细的错误码。

© All Rights Reserved            updated 2024-08-23 10:14:55

results matching ""

    No results matching ""