Очистка Корзины

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

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

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

Запрос удаления следует отправлять с помощью метода DELETE. Если в запросе не указан конкретный ресурс, Корзина очищается полностью.

https://cloud-api.yandex.net/v1/disk/trash/resources
 ? [path=<путь к удаляемому ресурсу>]
Query-параметры
path

Путь к удаляемому ресурсу относительно корневого каталога Корзины. Например, %2Fbar%2Fphoto.png. Если параметр не задан, Корзина очищается полностью.

Путь в значении параметра следует кодировать в URL-формате.

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

Очистка Корзины может занять неопределенное время. В зависимости от статуса операции, сервер Яндекс.Диска возвращает один из двух вариантов ответа:

  • Если к данному моменту запрос удалось обработать без ошибок, API отвечает кодом 204 No Content.

  • Если операция очистки была запущена, но еще не завершилась, Яндекс.Диск отвечает кодом 202 Accepted.

    Приложения должны самостоятельно следить за статусами запрошенных операций. Яндекс.Диск возвращает ссылку на статус запущенной по запросу операции в теле ответа, в объекте Link.

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

    {
      "href": "https://cloud-api.yandex.net/v1/disk/operations?id=33ca7d03ab21ct41b4a40182e78d828a3f8b72cdb5f4c0e94cc4b1449a63a2fe",
      "method": "GET",
      "templated": false
    }
    Описание элементов ответа
    ЭлементОписание
    href

    URL. Может быть шаблонизирован, см. ключ templated.

    method

    HTTP-метод для запроса URL из ключа href.

    templated

    Признак URL, который был шаблонизирован согласно RFC 6570. Возможные значения:

    • «true» — URL шаблонизирован: прежде чем отправлять запрос на этот адрес, следует указать нужные значения параметров вместо значений в фигурных скобках.
    • «false» — URL может быть запрошен без изменений.

Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.