OSS 文件上传
调用方直接上传文件到优资快报 OSS。可只存文件拿公开 URL,也可指定 purpose 走与 /admin/file-upload 相同的 Semrush Excel 异步处理。
POST /api/admin/oss/upload用途
后台「文件上传」会把 Excel 存到 OSS,再创建 upload_tasks 异步解析。本接口把同一能力开放给 API / MCP 调用方。
purpose=general(默认):只上传 OSS,返回url/keypurpose=backlinks:Semrush 外链 Excel/CSV,后台处理逻辑与 file-upload 一致,返回taskIdpurpose=seo_ranking:Semrush 关键词 Excel/CSV,同上
认证
Authorization: Bearer <API_KEY> 或登录 Token;亦可 X-API-Key。
方式一:JSON + Base64(适合 MCP)
POST /api/admin/oss/upload
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"fileName": "semrush-backlinks.xlsx",
"contentBase64": "<BASE64>",
"contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"purpose": "backlinks"
}方式二:multipart(适合大文件 / 脚本)
curl -X POST "https://youzikuaibao.com.cn/api/admin/oss/upload" \ -H "Authorization: Bearer <API_KEY>" \ -F "file=@./semrush-keywords.xlsx" \ -F "purpose=seo_ranking"
参数
| 字段 | 说明 |
|---|---|
| fileName | JSON 必填;multipart 用文件名 |
| contentBase64 | JSON 必填;可带 data:...;base64, 前缀 |
| contentType | 可选 MIME |
| purpose | general|backlinks|seo_ranking,默认 general |
| category | 仅 general:OSS 子目录,默认 api |
| file | multipart 文件字段名 |
大小限制:general 20MB;backlinks 50MB;seo_ranking 10MB(与后台上传一致)。
响应示例(Semrush 任务)
{
"success": true,
"message": "外链文件上传成功,正在后台处理",
"data": {
"purpose": "backlinks",
"taskId": 1234,
"url": "https://....aliyuncs.com/uploads/backlinks/...",
"key": "uploads/backlinks/...",
"fileName": "semrush-backlinks.xlsx",
"size": 204800
}
}进度可在后台「上传任务」查看,或沿用现有 upload-tasks 接口按 taskId 查询。
MCP
工具名 upload_oss_file。传 fileName + contentBase64 + 可选 purpose。大文件请改用 HTTP multipart。
