Документация по iSpring Learn

Дерево страниц

ДОСТУПНО В BUSINESS ПОДПИСКЕ

Запрос: POST /users/work-leave-status

Права для выполнения запроса 

Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками с правом на изменение персональной информации.

Администратор подразделения и пользователь с ролью с индивидуальными настройками могут добавить статус отсутствия пользователя только в тех подразделениях, которыми управляют.

Заголовки и параметры запроса

Заголовок

Описание

Authorization (обязательный)Токен доступа. Вы можете получить токен с помощью запроса
ПараметрОписание
userid (обязательный)

ID пользователя, для которого вы хотите добавить статус отсутствия

workLeaveReason (обязательный)

Причины отсутствия:

  • Отсутствует —  OutOfTheOffice,
  • В отпуске — OnVacation,
  • В отгуле — PersonalLeave,
  • В командировке — BusinessTrip,
  • На больничном — SickLeave,
  • В отпуске по уходу за ребенком — ParentalLeave,
  • В учебном отпуске — EducationalLeave
startDate (необязательный, но если не указан, считается равным текущей дате)

Дата начала отсутствия. Указывается в формате yyyy-mm-dd

endDate (необязательный)

Дата завершения отсутствия. Указывается в формате yyyy-mm-dd

Коды ответов

Код

Текст

Описание

200OKСтатус отсутствия добавлен. Тело ответа будет пустым
400Bad RequestОшибка в запросе
401UnauthorizedОшибка авторизации
403Permission DeniedУ пользователя нет прав для добавления. Например, Администратор подразделения не может добавить статус отсутствия для пользователя из подразделения, которым не управляет

Пример запроса

POST /user https/1.1
Host: api-learn.ispringlearn.ru 
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE 
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <workLeaveStatuses>
    <userId>76a38028-c8b7-11ed-a616-0542ac15004f</userId>
    <workLeaveReason>SickLeave</workLeaveReason>
    <startDate>2024-01-12</startDate>
    <endDate>2024-01-15</endDate>
  </workLeaveStatuses>
  <workLeaveStatuses>
    <userId>f5bafbba-c7eb-11ed-a327-0242ac12004e</userId>
    <workLeaveReason>PersonalLeave</workLeaveReason>
    <startDate>2024-01-12</startDate>
    <endDate>2024-01-20</endDate>
  </workLeaveStatuses>
</request>

Пример ответа

https/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
  • Нет меток