文件存储 API
Storage API 提供基于 Cloudflare R2 的临时文件存储服务。支持多种上传方式，通过全球 CDN 访问文件。
功能特点
- 多种上传方式: Base64、multipart/form-data 或远程 URL
- 全球 CDN: 文件通过 Cloudflare 边缘网络分发
- 自动过期: 文件 1 天后自动删除
- 中国加速: 专用中国节点，访问更快
认证方式
所有上传接口需要 Bearer Token 认证：
Authorization: Bearer YOUR_API_KEY
基础 URL
https://files-api.ffhub.io
快速示例
curl -X POST https://files-api.ffhub.io/api/upload/file \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.png"
响应格式
所有上传接口返回相同的响应格式：
{
"url": "https://storage.ffhub.io/uploads/{user_id}/{hash}.png",
"cn_url": "https://beijing-user-upload-tmp.tos-cn-beijing.volces.com/uploads/{user_id}/{hash}.png",
"key": "uploads/{user_id}/{hash}.png",
"md5": "d41d8cd98f00b204e9800998ecf8427e",
"size": 12345,
"content_type": "image/png",
"expires_at": "2024-01-17T00:00:00.000Z"
}
上传方式
| 方式 | 接口 | 使用场景 |
|---|
| 文件上传 | POST /api/upload/file | 通过表单直接上传文件 |
| Base64 | POST /api/upload/base64 | 浏览器或 API 编码数据 |
| URL | POST /api/upload/url | 下载并存储远程文件 |
文件会在 1 天后自动删除。此服务仅用于临时存储。如需永久保存，请在文件过期前下载。
下一步
