Downloading a file from Yandex Disk

To download a file from Yandex Disk:

1. Request a download URL.
2. Download the file from the address, using the same OAuth token as in the original request.

Download URL request

To get a direct download URL, send the current file path on Yandex Disk to the API.

Request format

Use the GET method to send a request for a download URL.

https://cloud-api.yandex.net/v1/disk/resources/download
 ? path=<path to the file being downloaded>
 & [fields=<properties to include in the response>]

path*

The path to the file being downloaded. For example, %2Fbar%2Fphoto.png.

The path in the parameter value should be encoded in URL format.

fields

List of JSON properties to include in the response. Keys not specified in this list are omitted when generating a response. If the parameter isn't specified, the response is returned in full without omitting anything.

Key names should be separated by commas, and embedded keys should be separated by dots. For example: name,_embedded.items.path.

* Required parameter.

Response format

If the request is processed without errors, the API returns the 200 OK code. The Link object in the response body contains the URL generated to download the file. The URL has a limited lifetime.

If the request caused an error, the relevant response code is returned, and the response body contains an error description.

Sample response:

{
  "href": "https://downloader.dst.yandex.ru/disk/...",
  "method": "GET",
  "templated": false
}

Downloading a file from a given URL

Use the GET method to download the file:

https://downloader.dst.yandex.ru/disk/53139aa0et584d3bac7eeab405d3574b/535320b4/YyjTJtEHob8R5WbpojJbiiUuU2HC_2JSTU0gW9qE0NHGW2uncmBjM_-IXun3Msyij96FTHQGSX-fDL-XwokDvA%3D%3D?uid=202727674&filename=photo.png&disposition=attachment&hash=&limit=0&content_type=application%2Fx-www-form-urlencoded&fsize=34524&hid=93528043563b8r55723a253f4730290a&media_type=document

If the request is processed without errors, the API returns the 200 OK code.