北森 API

获取休假数据

POST

/AttendanceOpen/api/v1/Vacation/GetList

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

适用场景：根据休假开始日期获取休假数据

警告信息：-

tips：同步执行，查询页位置从1开始，每次查询数量默认100条，最多300条

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/AttendanceOpen/api/v1/Vacation/GetList' \
--header 'Content-Type: application/json' \
--data-raw '{
	"Day": "2020-07-28",
	"PageIndex": 1,
	"PageSize": 1
}'

响应示例

{
  "Data": {
    "VacationList": [
      {
        "VacationId": "string",
        "AttendanceOrg": 0,
        "StaffId": 0,
        "StaffEmail": "string",
        "VacationType": "string",
        "VacationStartDateTime": "string",
        "VacationStopDateTime": "string",
        "VacationDuration": 0,
        "DayValueOfDuration": 0,
        "VacationDurationIncludeUnit": "string",
        "DocumentType": "string",
        "Reason": "string",
        "ApproveStatus": "string",
        "Applicant": 0,
        "ApplicantEmail": "string",
        "ApplyTime": "string",
        "JointApplyType": "string",
        "Remark": "string",
        "Properties": {
          "property1": {},
          "property2": {}
        },
        "CreatedTime": "2019-08-24T14:15:22Z",
        "ModifiedTime": "2019-08-24T14:15:22Z",
        "HalfDayStartOption": 0,
        "HalfDayStopOption": 0
      }
    ],
    "Total": 0
  },
  "Code": "Succeed",
  "Message": "string"
}

请求参数

Body 参数application/json

Day

string <date-time>

必需

休假开始日期示例：2020-11-11

PageIndex

integer <int32>

可选

查询页起始位置，必须大于0，默认1

PageSize

integer <int32>

可选

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

示例

返回响应

🟢200OK

application/json

Body

Data

object

可选

VacationList

array [object {23}]

休假项

可选

Total

integer <int32>

可选

数据总量，如：100

Code

enum<string>

可选

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

枚举值:

SucceedPartSucceedNoPermissionFailed

Message

string

错误信息

可选

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

根据审批通过时间获取休假数据

获取员工已对冲的休假信息