上传文件并获取唯一加密的 download_id。
| 参数 | 位置 | 类型 | 必须 | 说明 |
|---|---|---|---|---|
| file | FormData | File | 是 | 二进制文件流 (Max 20MB) |
请求示例:
curl -X POST "https://panyun.pages.dev/api/upload" \
-F "file=@photo.jpg"
响应示例:
{
"success": true,
"download_id": "dl_x789",
"download_url": "https://panyun.pages.dev/d/dl_x789"
}
根据下载 ID 重定向至 CDN 或直接输出流。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
| download_id | Path | String | 格式如 dl_abc123 |
响应头参考:
HTTP/1.1 200 OK
Content-Disposition: attachment; filename="file.zip"
Content-Type: application/octet-stream
| 状态码 | 错误短语 | 详细描述 |
|---|---|---|
413 | File too large | 文件太大了 |
404 | Not Found | 文件不存在 |
502 | API Error | 上游服务连接超时 |