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

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

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

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

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

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

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 может быть запрошен без изменений.

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