menu PanYun开发者 - API文档
cloud_upload
PanYun API
backup
上传文件
file_download
获取文件
error_outline
错误码
POST
/api/upload

上传文件并获取唯一加密的 download_id

参数位置类型必须说明
fileFormDataFile二进制文件流 (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"
}
GET
/d/{download_id}

根据下载 ID 重定向至 CDN 或直接输出流。

参数位置类型说明
download_idPathString格式如 dl_abc123

响应头参考:

HTTP/1.1 200 OK
Content-Disposition: attachment; filename="file.zip"
Content-Type: application/octet-stream
错误码参考
状态码错误短语详细描述
413File too large文件太大了
404Not Found文件不存在
502API Error上游服务连接超时