北森 API

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

POST

/AttendanceOpen/api/v1/Vacation/GetVacationMapping

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

适用场景：根据员工和起止日期获取对冲完的休假数据，数据维度为每人每天一条（有休假的情况），不会整合多天的休假记录

警告信息：UserIds不可为空
开始日期不可晚于结束日期
（人*天）次不允许大于300

tips：同步执行接口

错误码示例

错误码：417 错误信息：（人*天）次不允许大于300 解决方法：缩小时间范围或者减少人员数量
错误码：417 错误信息：开始日期不可晚于结束日期解决方法：修改开始和结束时间
错误码：417 错误信息：接口发生未知错误，请联系假勤开发团队！解决方法：联系客服和开发人员
错误码：500 错误信息：内部错误解决方法：联系客服和北森开发团队

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/AttendanceOpen/api/v1/Vacation/GetVacationMapping' \
--header 'Content-Type: application/json' \
--data-raw '{
  "StartDate": "2021-07-01",
  "StopDate": "2021-08-21",
  "UserIds": [
    116126780
  ]
}'

响应示例

{
  "Data": {
    "VacationList": [
      {
        "StaffId": 0,
        "VacationDate": "2019-08-24T14:15:22Z",
        "VacationTimeRange": {
          "StartDateTime": "2019-08-24T14:15:22Z",
          "StopDateTime": "2019-08-24T14:15:22Z",
          "PObjectDataID": "string"
        },
        "VacationItemCode": "string",
        "VacationItemName": "string",
        "VacationApproveStatus": 0,
        "VacationApproveStatusName": "string"
      }
    ],
    "Total": 0
  },
  "Code": "Succeed",
  "Message": "string"
}

请求参数

Body 参数application/json

StartDate

string <date-time>

必需

休假日期开始，如：2021-07-01

StopDate

string <date-time>

必需

休假日期结束，如：2021-08-21

UserIds

array[integer <int32>]

必需

员工，如：[ 116126780,116126782,116126783 ]

示例

返回响应

🟢200OK

application/json

Body

Data

object

可选

VacationList

array [object {7}]

可选

对冲后的休假记录集合

Total

integer <int32>

可选

数据总量，如：100

Code

enum<string>

可选

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

枚举值:

SucceedPartSucceedNoPermissionFailed

Message

string

错误信息

可选

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

获取休假数据

接收休假数据

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

错误码示例#

请求参数

返回响应

错误码示例