Публикация файла или папки

Файлы и папки на Диске можно публиковать — генерировать ссылки, по которым они будут доступны не только владельцу. Доступ к уже опубликованному ресурсу можно закрыть.

Опубликованный ресурс получает два новых атрибута:

• public_key — ключ опубликованного ресурса. По этому ключу другие приложения смогут получить метаданные опубликованного ресурса.
• public_url — публичная ссылка на ресурс вида https://yadi.sk/.... Пользователи, которым владелец ресурса передаст эту ссылку, смогут открыть опубликованную папку или скачать файл.

Когда владелец закрывает доступ к ресурсу, эти атрибуты удаляются.

Публикация ресурса

Закрытие доступа к ресурсу

Публикация ресурсаПубликация ресурса

Ресурс становится доступен по прямой ссылке. Опубликовать ресурс можно только с OAuth-токеном владельца файла.

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

Запрос публикации следует отправлять с помощью метода PUT.

https://cloud-api.yandex.net/v1/disk/resources/publish
 ? path=<путь к публикуемому ресурсу>

path*

Путь к публикуемому ресурсу. Например, %2Fbar%2Fphoto.png.

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

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

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

Если запрос был обработан без ошибок, API отвечает кодом 200 OK и возвращает ссылку на мета-информацию об опубликованном ресурсе в теле ответа (в объекте Link).

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

{
  "href": "https://cloud-api.yandex.net/v1/disk/resources?path=disk%3A%2Fbar%2Fphoto.png",
  "method": "GET",
  "templated": false
}

Закрытие доступа к ресурсуЗакрытие доступа к ресурсу

Ресурс теряет атрибуты public_key и public_url, публичные ссылки на него перестают работать. Закрыть доступ к ресурсу можно только с OAuth-токеном владельца ресурса.

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

Закрывать доступ к ресурсу следует с помощью метода PUT.

https://cloud-api.yandex.net/v1/disk/resources/unpublish
 ? path=<путь к закрываемому ресурсу>

path*

Путь к закрываемому ресурсу. Например, %2Fbar%2Fphoto.png.

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

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

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

Если запрос был обработан без ошибок, API отвечает кодом 200 OK и возвращает ссылку на мета-информацию о закрытом ресурсе в теле ответа (в объекте Link).

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

{
  "href": "https://cloud-api.yandex.net/v1/disk/resources?path=disk%3A%2Fbar%2Fphoto.png",
  "method": "GET",
  "templated": false
}