Связаться с намиПодключиться

Удалить чеклист

Статья создана
Обновлена 26 августа 2024 г.

Запрос позволяет удалить все пункты чеклиста в сущности. Действие не может быть отменено.

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

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

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

DELETE /v2/entities/<тип_сущности>/<идентификатор_сущности>/checklistItems
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки

  • Host

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

    api.tracker.yandex.net

  • Authorization

    OAuth-токен в формате OAuth <OAuth-токен>, например:

    OAuth 0c4181a7c2cf4521964a72ff********

  • X-Org-ID или X-Cloud-Org-ID

    Идентификатор организации. Узнать его можно на странице организаций Tracker.

    • Если к Tracker привязана только организация Яндекс 360 для бизнеса, используется заголовок X-Org-ID.
    • Если к Tracker привязана только организация Yandex Cloud Organization, используется заголовок X-Cloud-Org-ID.
    • Если к Tracker одновременно привязаны организации Яндекс 360 для бизнеса и Yandex Cloud Organization, используется заголовок X-Org-ID и идентификатор организации Яндекс 360 для бизнеса.
Ресурс
Параметр Описание Тип данных
<тип_сущности> Тип сущности:
  • project — проект;
  • portfolio — портфель.
 Строка
<идентификатор_сущности> Идентификатор сущности. Чтобы получить идентификатор, посмотрите список сущностей. Строка
<идентификатор_проекта_или_портфеля> Идентификатор проекта или портфеля (значение поля shortId). Его можно использовать в запросе вместо идентификатора сущности. Строка

Важно

Идентификатор сущности не совпадает с идентификатором проекта или портфеля.

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

Дополнительные параметры

Параметр Описание Тип данных
notify Уведомлять пользователей, которые указаны в полях Автор, Ответственный, Участники, Заказчики и Наблюдатели. Значение по умолчанию — true. Логический
notifyAuthor Уведомлять автора изменений. Значение по умолчанию — false. Логический
fields Дополнительные поля сущности, которые будут включены в ответ. Строка
expand Дополнительная информация, которая будет включена в ответ:
  • attachments — вложенные файлы.
 Строка

Пример: Удалить все пункты в чеклисте

  • Используется HTTP-метод DELETE.
  • В чеклисте удаляются все пункты.
  • В ответе выводится информация о чеклисте (fields=checklistItems).
DELETE /v2/entities/project/<идентификатор_проекта>/checklistItems?fields=checklistItems
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

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

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

Тело ответа содержит JSON-объект с параметрами сущности, из которой удален чеклист.

{
    "self": "https://api.tracker.yandex.net/v2/entities/project/6586d6fee2b9ef74********", 
    "id": "6586d6fee2b9ef74********",
    "version": 133,
    "shortId": 0,
    "entityType": "project",
    "createdBy": {
        "self": "api.tracker.yandex.net/v2/users/19********",
        "id": "19********",
        "display": "Имя Фамилия",
        "cloudUid": "ajeppa7dgp53********",
        "passportUid": "15********"
    },
    "createdAt": "2023-12-13T15:06:27.231Z",
    "updatedAt": "2023-12-13T15:06:27.231Z",
    "fields": {
        "checklistItems": []
    }
}
Параметры ответа
Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о сущности. Строка
id Идентификатор сущности. Строка
version Версия сущности. Каждое изменение параметров увеличивает номер версии. Число
shortId Идентификатор проекта или портфеля. Число
entityType Тип сущности:
  • project — проект;
  • portfolio — портфель.
 Строка
createdBy Объект с информацией о создателе сущности. Объект
createdAt Дата создания сущности в формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Строка
updatedAt Дата последнего обновления сущности в формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Строка
fields Дополнительные поля. Объект

Поля объекта createdBy

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Число
display Отображаемое имя пользователя. Строка
cloudUid Уникальный идентификатор пользователя в Yandex Cloud Organization. Строка
passportUid Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. Строка

Поля объекта fields

Параметр Описание Тип данных
checklistItems Информация о пунктах чеклиста. Массив объектов

Поля объекта checklistItems

Параметр Описание Тип данных
id Идентификатор пункта чеклиста. Число
text Текст пункта чеклиста. Строка
checked Отметка о выполнении пункта:
  • true — пункт отмечен как выполненный;
  • false — пункт не отмечен как выполненный.
 Логический
checklistItemType Тип пункта чеклиста:
  • standard;
  • metric;
  • criterion;
  • filter.
 строка

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

400
Один или несколько параметров запроса имеют недопустимое значение.
404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
422
Ошибка валидации JSON, запрос отклонен.
Предыдущая
Переместить пункт
Следующая
Удалить один пункт