GetDownloadUrl - 获取文件下载地址

获取文件下载地址。

调试

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

授权信息

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

请求语法

POST /v2/file/get_download_url HTTP/1.1

请求参数

名称类型必填描述示例值
bodyobject

请求体参数。

share_idstring

分享 id。 如果通过分享操作文件,请携带x-share-token header 鉴权并传递此字段,此时drive_id无效。否则请使用aksk或者access_token方式鉴权,并传递drive_id字段。 share_iddrive_id两者必须有一个字段赋值。

7JQX1FswpQ8
drive_idstring

空间 id。

1
file_idstring

文件 id。

9520943DC264
file_namestring

文件名,最长 1024 字符。

1.txt
expire_secinteger

下载地址过期时间,单位为秒,最长 115200 秒,默认为 900 秒。

100

返回参数

名称类型描述示例值
object

Schema of Response。

urlstring

公网下载地址 (开启智能数据域名后,根据客户网络情况选取最优线路,返回对应域名下载地址)。

https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
internal_urlstring

vpc 内下载地址 (开启智能数据域名后将不使用该字段,根据请求该参数会自适应返回在 URL 字段值内,如需使用该字段请联系 PDS 技术支持)。

https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
cdn_urlstring

cdn 下载地址 (开启智能数据域名后不使用该字段,根据请求该参数会自适应返回在 URL 字段值内,如需使用该字段请联系 PDS 技术支持)。

https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
expirationstring

下载链接的过期时间。

2022-01-02T15:04:05.999Z07:00
sizelong

文件大小,单位:byte。

10
crc64_hashstring

crc64 值。

5498595269368962671
content_hashstring

文件内容 hash。

EA4942AA8761213890A5C386F88E6464D2C31CA1
content_hash_namestring

文件内容 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"
}

错误码

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