北森 API

获取工时数据

POST

/AttendanceOpen/api/v1/WorkingHour/GetWorkingHourList

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：通过时间范围获取工时数据

警告信息：-

tips：同步执行；查询页位置从1开始，每页查询数量默认100条，最多300条；自定义字段在Properties内部

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/AttendanceOpen/api/v1/WorkingHour/GetWorkingHourList' \
--header 'Content-Type: application/json' \
--data-raw '{
	"StartDate": "2020-10-29",
	"EndDate": "2020-11-30",
	"PageIndex": 1,
	"PageSize": 1
}'

响应示例

{
  "Data": {
    "WorkingHourInfos": [
      {
        "Name": "string",
        "Email": "string",
        "AttendanceOrg": "string",
        "StartDate": "string",
        "EndDate": "string",
        "StandardWorkingHours": 0,
        "StandardWorkingHoursAdjust": 0,
        "ActualStandardWorkingHours": 0,
        "AttendanceWorkingHours": 0,
        "AttendanceWorkingHoursAdjust": 0,
        "ActualAttendanceWorkingHours": 0,
        "CarryOverWorkingHours": 0,
        "DifferentWorkingHours": 0,
        "CarryOverStatus": "string",
        "BalanceToMonthlyLimit": 0,
        "BalanceToVacationLimit": 0,
        "BalanceToNextCycleLimit": 0,
        "Remark": "string",
        "Properties": {
          "property1": {},
          "property2": {}
        },
        "CreatedTime": "2019-08-24T14:15:22Z",
        "ModifiedTime": "2019-08-24T14:15:22Z"
      }
    ],
    "Total": 0
  },
  "Code": "Succeed",
  "Message": "string"
}

请求参数

Body 参数application/json

StartDate

string <date-time>

必需

查询开始时间如：2020-11-11

EndDate

string <date-time>

必需

查询结束时间如：2020-11-11

PageIndex

integer <int32>

页码默认1

可选

PageSize

integer <int32>

可选

每页数量默认100 最高设置300

示例

返回响应

🟢200OK

application/json

Body

Data

object

可选

WorkingHourInfos

array [object {21}]

工时数据列表

可选

Total

integer <int32>

可选

数据总量，如：100

Code

enum<string>

可选

返回状态编码
200 成功
206 部分成功
401 无权限
417 失败

枚举值:

SucceedPartSucceedNoPermissionFailed

Message

string

错误信息

可选

修改于 2021-10-13 10:54:22

接收打卡数据

添加工时