Skip to main content
GET
/
files
/
{file_id}
/
preview
Error
A valid request URL is required to generate request examples
"<string>"

Authorizations

​
Authorization
string
header
required

API Key 认证。对于所有 API 请求，请在 Authorization HTTP 头中包含您的 API Key，并加上 Bearer 前缀。示例：Authorization: Bearer {API_KEY}。强烈建议将 API Key 存储在服务端，不要在客户端共享或存储，以避免 API Key 泄漏导致严重后果。

Path Parameters

​
file_id
string<uuid>
required

要预览的文件唯一标识符，从 上传文件 API 响应中获取。

Query Parameters

​
as_attachment
boolean
default:false

如果为 true，则强制文件以附件形式下载，而不是在浏览器中预览。

​
user
string

用户标识符，用于终端用户上下文。

Response

返回原始文件内容。Content-Type 头设置为文件的 MIME 类型。如果 as_attachment 为 true，文件将以 Content-Disposition: attachment 方式作为下载返回。

The response is of type file.