--- metadata: - name: generator content: Diplodoc Platform v5.44.0 alternate: - https://yandex.ru/dev/disk-api/doc/en/reference/upload-ext.md - https://yandex.ru/dev/disk-api/doc/ru/reference/upload-ext.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt # Сохранение файла из интернета на Диск Яндекс Диск может скачать файл на Диск пользователя. Для этого следует передать в запросе URL файла и следить за ходом операции. Если при скачивании возникла ошибка, Диск не будет пытаться скачать файл еще раз. Если сразу на Диск скачать файл не удается, можно попробовать скачать файл самостоятельно и загрузить его с помощью запроса [Загрузка файла на Диск](https://yandex.ru/dev/disk-api/doc/ru/reference/upload.md). ## Формат запроса {#request} Метод: ##POST##. ``` https://cloud-api.yandex.net/v1/disk/resources/upload ? [url](*popup-url)=<ссылка на скачиваемый файл> & [path](*popup-path)=<путь к папке, в которую нужно скачать файл> & [[fields](*popup-fields)=<свойства, которые нужно включить в ответ>] & [[disable_redirects](*popup-disable_redirects)=<признак запрета редиректов>] ``` ### Описание query-параметров {#query} url[*](*popup-a) : Ссылка на скачиваемый файл. Например, `http%3A%2F%2Fexample.com%2Fphoto.png`. Максимальная длина имени загружаемого файла — 255 символов; максимальная длина пути — 32760 символов. Путь в значении параметра следует кодировать в URL-формате. path[*](*popup-a) : Путь на Диске, по которому должен быть доступен скачанный файл. Например, `disk%3A%2Fbar%2Fphoto.png`. Путь в значении параметра следует кодировать в URL-формате. fields : Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений. Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например: `name,_embedded.items.path`. disable_redirects : Параметр позволяет запретить редиректы по адресу, заданному в параметре `url`. Допустимые значения: - `false` — обнаружив редирект, Диск должен скачать файл с нового адреса. Это значение используется по умолчанию. - `true` — обнаружив редирект, Диск не должен переходить по нему и что-либо скачивать. \* Обязательный параметр. ### Заголовок {#header} ``` Authorization: OAuth ``` ## Формат ответа {#response} ### Успешный ответ Скачивание файла может занять неопределенное время. Если операция скачивания была запущена, API отвечает кодом `202 Accepted` и ссылкой на статус операции (в теле ответа в объекте [Link](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#link)). Ваше приложение должно следить за [статусом операции](https://yandex.ru/dev/disk-api/doc/ru/reference/operations.md), используя полученную ссылку: - Статус `success` значит, что файл скачан успешно. - Статус `failed` значит, что файл скачать не удалось. В этом случае ваше приложение может попробовать скачать файл самостоятельно и загрузить его с помощью запроса [Загрузка файла на Диск](https://yandex.ru/dev/disk-api/doc/ru/reference/upload.md). Пример ответа: ```json { "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](http://tools.ietf.org/html/rfc6570). Возможные значения: - «true» — URL шаблонизирован: прежде чем отправлять запрос на этот адрес, следует указать нужные значения параметров вместо значений в фигурных скобках. - «false» — URL может быть запрошен без изменений.|| |# ### Ответ с ошибкой Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит [описание ошибки](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#error). Некоторые возможные ошибки: * `400` — Некорректные данные. * `401` — Не авторизован. * `403` — API недоступно. Ваши файлы занимают больше места, чем у вас есть. Удалите лишнее или увеличьте объем Диска. * `404` — Не удалось найти запрошенный ресурс. * `406` — Ресурс не может быть представлен в запрошенном формате. * `409` — Ресурс по указанному пути уже существует. * `413` — Загрузка файла недоступна, файл слишком большой (`UPLOAD_FILE_SIZE_LIMIT_EXCEEDED`). Максимальный размер одного файла для загрузки на Диск зависит от тарифа. Ознакомиться с ограничениями можно в [Справке Яндекс 360](https://yandex.ru/support/yandex-360/customers/disk/web/ru/uploading) и в [Справке Яндекс 360 для бизнеса](https://yandex.ru/support/yandex-360/business/disk/web/ru/uploading). * `423` — Загрузка файлов недоступна, можно только просматривать и скачивать. Возможные причины ошибки: - Ведутся технические работы. - Вы достигли ограничения по загрузке файлов (`UPLOAD_TRAFFIC_LIMIT_EXCEEDED`). Про месячный лимит загрузки на Диск можно прочитать в [Справке Яндекс 360](https://yandex.ru/support/yandex-360/customers/disk/web/ru/enlarge/disk-space#limit) и в [Справке Яндекс 360 для бизнеса](https://yandex.ru/support/yandex-360/business/disk/web/ru/enlarge/disk-space#limit). * `429` — Слишком много запросов. * `503` — Сервис временно недоступен. * `507` — Недостаточно свободного места. [*popup-url]: Ссылка на скачиваемый файл. Например, `http%3A%2F%2Fexample.com%2Fphoto.png`. Максимальная длина имени загружаемого файла — 255 символов; максимальная длина пути — 32760 символов. Путь в значении параметра следует кодировать в URL-формате. [*popup-path]: Путь на Диске, по которому должен быть доступен скачанный файл. Например, `disk%3A%2Fbar%2Fphoto.png`. Путь в значении параметра следует кодировать в URL-формате. [*popup-fields]: Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений. Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например: `name,_embedded.items.path`. [*popup-disable_redirects]: Параметр позволяет запретить редиректы по адресу, заданному в параметре `url`. Допустимые значения: - `false` — обнаружив редирект, Диск должен скачать файл с нового адреса. Это значение используется по умолчанию. - `true` — обнаружив редирект, Диск не должен переходить по нему и что-либо скачивать. [*popup-a]: Обязательный параметр.