Перейти к основному содержимому

Получить годы календаря по внешнему ID

GET 
/api/v1/clients/:clientId/calendarsByExternalId/:externalId/years

Описание метода​

Для успешного выполения запросов необходимо выполнение следующих условий:

  • Внешний IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. календаря задан.
  • Календарь существует по заданному внешнему IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID..
  • В запросе задан query-параметр yearFrom, содержащий начало диапазона годов, и он является числом.
  • Если в запросе задан query-параметр yearTo, содержащий окончание диапазона годов, то он является числом.
  • Начало диапазона годов не превышает конец диапазона.

Валидации запроса​

  • Запрос содержит yearFrom.
  • yearFrom является числом.
  • Если запрос содержит параметр yearTo, то он является числом.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. календаря (внешний или внутренний) имеет допустимый формат.
  • Пользователь клиента существует и относится к заданному клиенту.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. календаря обладает верным форматом.
  • Проверяет, что в запросе задан query-параметр 'yearFrom', содержащий начало диапазона годов, и что он является числом.
  • Проверяет, что если в запросе задан query-параметр 'yearTo', содержащий окончание диапазона годов, то он является числом.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
  • Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
  • Проверяет, что клиент не удален.

Request​

Responses​

Успешная операция.