Удалить отсутствия сотрудников

Запрос позволяет удалить одну или несколько записей об отсутствии по их идентификаторам. Несуществующие идентификаторы игнорируются без ошибок.

DELETE

https://api.tracker.yandex.net/v3/gaps?gapIds=<id_отсутствия>

Формат запроса

Перед выполнением запроса получите доступ к API.

Для выполнения запроса требуются права администратора.

Чтобы удалить записи об отсутствии, используйте HTTP-запрос с методом DELETE. Идентификаторы записей укажите в параметрах запроса.

DELETE /v3/gaps?gapIds=<идентификатор_отсутствия>
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки

  • Host: адрес узла, предоставляющего API.

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Identity Hub. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • если к Трекеру привязана организация Яндекс 360 для бизнеса, используйте заголовок X-Org-ID,

    • если к Трекеру привязана организация Yandex Identity Hub, используйте заголовок X-Cloud-Org-ID.

    Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

Параметры запроса

Обязательные параметры

Параметр Описание Тип данных
gapIds Идентификаторы записей об отсутствии, которые нужно удалить. Можно передать несколько значений через запятую. Максимальное количество — 100, длина каждого идентификатора не должна превышать 128 символов Массив строк

Пример: Удалить несколько записей об отсутствии

  • Используется HTTP-метод DELETE.
  • Удаляются две записи с идентификаторами 68340a1f2b4c1a3d5e7f9011 и 68340a1f2b4c1a3d5e7f9012.
DELETE /v3/gaps?gapIds=68340a1f2b4c1a3d5e7f9011,68340a1f2b4c1a3d5e7f9012
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID: 1234******

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 204.

Тело ответа отсутствует.

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

401
Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
422
Ошибка валидации JSON, запрос отклонен.

Код 422 возвращается в следующих случаях:

  • количество переданных идентификаторов превышает 100;
  • длина одного из идентификаторов превышает 128 символов.
500
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
Предыдущая
Найти отсутствия
Следующая
Возможные коды ответа