Create download URL

POST

/file/url

Create a temporary anonymous URLs to download file content.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Server-side batch downloadGet download URL for multiple files

{
    "uris": [
        "cloudreve://my/The%20Man.mp3",
        "cloudreve://my/Taylor%20Swift%20-%20Untouchable%20(Taylor%E2%80%99s%20Version).mp3",
        "cloudreve://my/%E9%81%A0%E9%87%8E%E3%81%B2%E3%81%8B%E3%82%8B%20-%20LOVE%202000.mp3",
        "cloudreve://my/Taylor%20Swift%20-%20Guilty%20as%20Sin.mp3"
    ],
    "archive": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Server-side batch downloadGet download URL for multiple files

curl --location --request POST '/file/url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uris": [
        "cloudreve://my/The%20Man.mp3",
        "cloudreve://my/Taylor%20Swift%20-%20Untouchable%20(Taylor%E2%80%99s%20Version).mp3",
        "cloudreve://my/%E9%81%A0%E9%87%8E%E3%81%B2%E3%81%8B%E3%82%8B%20-%20LOVE%202000.mp3",
        "cloudreve://my/Taylor%20Swift%20-%20Guilty%20as%20Sin.mp3"
    ],
    "archive": true
}'

Responses

🟢200Success

application/json

Body

Examples

Server-side batch downloadGet download URL for multiple files

{
    "code": 0,
    "data": {
        "urls": [
            {
                "url": "http://localhost:5173/api/v4/file/archive/56bb8329-3afa-4137-9ebb-2a07b6ea19b9/archive.zip?sign=1CgU15Is0ezKeTVKE_OAu2tJJoB6lN5s_DvRXTcP7GQ%3D%3A1749525301"
            }
        ],
        "expires": "2025-06-10T11:15:01.186053+08:00"
    },
    "msg": ""
}

Modified at 2025-08-12 07:13:02

Move or copy files

Restore from trash bin