全部產品
Search
文件中心

Drive and Photo Service:GetDownloadUrl - 擷取檔案下載地址

更新時間:Feb 26, 2026

擷取檔案下載地址。

調試

您可以在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_iddrive_id兩者必須有一個欄位賦值。

7JQX1FswpQ8

drive_id

string

空間 id。

1

file_id

string

檔案 id。

9520943DC264

file_name

string

檔案名稱,最長 1024 字元。

1.txt

expire_sec

integer

下載地址到期時間,單位為秒,最長 115200 秒,預設為 900 秒。

100

response_content_type

string

video/mp4

返回參數

名稱

類型

描述

樣本值

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

integer

檔案大小,單位: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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情