调用GetDownloadUrl获取文件下载地址_网盘与相册服务(PDS)-阿里云帮助中心

获取文件下载地址。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/file/get_download_url HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
share_id	string	否	分享 id。如果通过分享操作文件，请携带`x-share-token` header 鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。 `share_id`和`drive_id`两者必须有一个字段赋值。	7JQX1FswpQ8
drive_id	string	否	空间 id。	1
file_id	string	是	文件 id。	9520943DC264
file_name	string	否	文件名，最长 1024 字符。	1.txt
expire_sec	integer	否	下载地址过期时间，单位为秒，最长 115200 秒，默认为 900 秒。	100

返回参数

名称	类型	描述	示例值
	object	Schema of Response。
url	string	公网下载地址（开启智能数据域名后，根据客户网络情况选取最优线路，返回对应域名下载地址）。	https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
internal_url	string	vpc 内下载地址（开启智能数据域名后将不使用该字段，根据请求该参数会自适应返回在 URL 字段值内，如需使用该字段请联系 PDS 技术支持）。	https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
cdn_url	string	cdn 下载地址（开启智能数据域名后不使用该字段，根据请求该参数会自适应返回在 URL 字段值内，如需使用该字段请联系 PDS 技术支持）。	https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
expiration	string	下载链接的过期时间。	2022-01-02T15:04:05.999Z07:00
size	long	文件大小，单位：byte。	10
crc64_hash	string	crc64 值。	5498595269368962671
content_hash	string	文件内容 hash。	EA4942AA8761213890A5C386F88E6464D2C31CA1
content_hash_name	string	文件内容 hash 算法名。	sha1

示例

正常返回示例

JSON格式

{
  "url": "https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "internal_url": "https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "cdn_url": "https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "expiration": "2022-01-02T15:04:05.999Z07:00",
  "size": 10,
  "crc64_hash": "5498595269368962671",
  "content_hash": "EA4942AA8761213890A5C386F88E6464D2C31CA1",
  "content_hash_name": "sha1"
}

错误码

访问错误中心查看更多错误码。