X-FILE 文件存储服务

产品简介

X-FILE 是面向开发者的安全文件存储与分发服务，支持多租户隔离、配额控制、带过期时间的下载链接及批量管理，适合处理临时分享、用户上传与内部资料投递。

快速体验

准备 sk- 私钥并调用 POST /x-file/upload 上传文件，支持设置过期时间 expiration 与最大下载次数 download_limit。
上传成功会返回 token 与下载地址，可直接嵌入前端或邮件。
使用 GET /x-file 查看文件列表与配额统计，或 GET /x-file/quota 单独查询配额。
若需撤回文件，调用 DELETE /x-file/delete?token= 即可立即失效。

核心能力

配额治理：内置用户级总容量、单文件大小限制与实时统计。
临时链接：自定义有效期与下载次数，过期自动清理。
多租户隔离：每个账户独立目录与权限控制，保障数据安全。
事件清理：结合事件总线，在用户注销时自动删除其文件资产。

API 参考

方法	路径	说明
`POST`	`/x-file/upload`	上传文件（multipart），支持 `expiration`、`download_limit`
`GET`	`/x-file`	获取文件列表及配额信息
`GET`	`/x-file/quota`	查询当前账户的配额使用情况
`GET`	`/x-file/download/{token}`	下载文件（公开链接，可分享给用户）
`DELETE`	`/x-file/delete?token=`	删除指定文件
`POST`	`/x-file/clear-all`	清空当前账户文件（需谨慎使用）

示例：上传并分享文件

export XAPI_KEY="你的XAPI-KEY" # sk- 开头的密钥

curl -X POST https://api.xabcstack.com/x-file/upload \
  -H "Authorization: Bearer $XAPI_KEY" \
  -F "[email protected]" \
  -F "expiration=7d" \
  -F "download_limit=10"

响应中的 token 可用于生成公开下载链接：https://api.xabcstack.com/x-file/download/{token}。

常见问题

最大文件尺寸？ 默认 256MB，可通过配额配置下调。
能否设置私有访问？ 支持，通过 POST /x-file/privacy 切换私有模式，仅凭 sk- 密钥可下载。
如何扩容？ 提交工单或使用管理员接口调整配额，所有改动实时生效。