All Products
Search

This Product

    Drive and Photo Service:GetDownloadUrl

    Document Center

    Drive and Photo Service:GetDownloadUrl

    Last Updated:Mar 20, 2026

    Mengambil URL unduhan untuk sebuah file.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Sintaks permintaan

    POST /v2/file/get_download_url HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    body

    object

    No

    share_id

    string

    No

    ID share. Jika Anda mengakses file melalui share, sertakan header `x-share-token` untuk otentikasi dan isi bidang ini. Dalam kasus tersebut, bidang `drive_id` akan diabaikan. Jika tidak, gunakan Pasangan Kunci Akses (AccessKey pair) atau token akses untuk otentikasi dan isi bidang `drive_id`. Anda harus menentukan salah satu dari `share_id` atau `drive_id`.

    7JQX1FswpQ8
    drive_id

    string

    No

    ID drive.

    1
    file_id

    string

    Yes

    ID file.

    9520943DC264
    file_name

    string

    No

    Nama file. Panjang maksimum adalah 1.024 karakter.

    1.txt
    expire_sec

    integer

    No

    Waktu hidup (TTL) URL unduhan, dalam detik. Nilai maksimum adalah 115200. Nilai default adalah 900.

    100
    response_content_type

    string

    No

    video/mp4

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema respons.

    url

    string

    URL unduhan publik. Jika Anda mengaktifkan titik akhir data cerdas, sistem akan memilih jalur jaringan terbaik untuk pelanggan dan mengembalikan URL unduhan dengan nama domain yang sesuai.

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

    string

    URL unduhan untuk digunakan dalam Virtual Private Cloud (VPC). Bidang ini tidak digunakan jika Anda mengaktifkan titik akhir data cerdas. Dalam kasus tersebut, sistem secara otomatis mengembalikan URL yang sesuai di bidang url. Untuk menggunakan bidang ini, hubungi dukungan teknis PDS.

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

    string

    URL unduhan Content Delivery Network (CDN). Bidang ini tidak digunakan jika Anda mengaktifkan titik akhir data cerdas. Dalam kasus tersebut, sistem secara otomatis mengembalikan URL yang sesuai di bidang url. Untuk menggunakan bidang ini, hubungi dukungan teknis PDS.

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

    string

    Waktu kedaluwarsa URL unduhan.

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

    integer

    Ukuran file, dalam byte.

    10
    crc64_hash

    string

    Nilai CRC-64.

    5498595269368962671
    content_hash

    string

    Hash dari konten file.

    EA4942AA8761213890A5C386F88E6464D2C31CA1
    content_hash_name

    string

    Nama algoritma hash untuk konten file.

    sha1

    Contoh

    Respons sukses

    JSONformat

    {
  "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"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.