Get Download URL

GET/web/v1/files/query/{fileBizId}/download-url JWT + Turnstile

Generates a pre-signed download URL for the specified file. The URL is time-limited and can be used to download the file directly without additional authentication.

Required Headers

Header	Example Value	Description
Content-Type	application/json	Request content type
Accept	application/json	Expected response type
X-Client-Hash		Client device fingerprint
Accept-Language	en, zh, zh-Hant, ja, vi	Response language (default: en)
Authorization	Bearer	JWT access token
X-Workspace-Id		Target workspace ID

Request Parameters

Name	Type	Required	In	Description
fileBizId	string	Required	path	File business ID
expiryMinutes	integer	Optional	query	URL expiry time in minutes. Default: `60`

Success Response

Success 200

{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": "https://storage.example.com/uploads/2026/03/21/file_abc123.pdf?X-Amz-Signature=..."
}

Error Responses

Unauthorized 401

{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}

Not Found 404

{
  "success": false,
  "code": "4040",
  "message": "File not found"
}

Notes

• The generated URL is pre-signed and does not require authentication headers to use.
• The URL expires after the specified duration (default 60 minutes).
• Prefer this endpoint over direct download for large files or when the client needs to delegate download to a browser or external tool.