Temp Cloud API 文档

Temp Cloud 用于把文件临时上传到 OBS，并生成公开分享链接。文件默认保留 3 天，适合爬虫抓取后快速分发下载链接。

核心特性

- 认证方式：X-API-Key 或 Authorization: Bearer <key>

- 上传后返回公开分享页链接与直链

- 文件在 3 天后自动删除

申请 API Key

登录后打开云盘页面，点击右上角三条横菜单，进入「Temp API Key」弹窗生成/刷新密钥。

API Base URL

https://chat.monasa.net/api/temp_cloud/v1

上传文件

POST /api/temp_cloud/v1/upload

请求：multipart/form-data

- file: 必填，上传文件

响应：

{
  "success": true,
  "share_id": "24位hex",
  "share_url": "https://chat.monasa.net/temp_cloud/share/<share_id>",
  "file_url": "https://...",
  "filename": "demo.zip",
  "content_type": "application/zip",
  "size": 12345,
  "expires_at": "2026-03-24T10:00:00+00:00"
}

获取分享预览信息

GET /api/temp_cloud/share_preview/{share_id}

cURL 示例

curl -X POST "https://chat.monasa.net/api/temp_cloud/v1/upload" \
  -H "X-API-Key: YOUR_KEY" \
  -F "file=@result.zip"