竞品商品批量导入

将与本系统「批量导入竞品」相同列名与格式的 Excel 写入当前环境的 CompetitorProduct 表。适用于从另一套相同结构的数据库/导出文件同步到本系统。

鉴权说明

username：用户在系统中登录用的用户名（与个人中心显示一致）。
token：用户在登录后进入个人中心 → API Token 管理，点击「生成新 Token」得到的临时密钥；默认有效期约 30 天，过期后需重新生成。
用户名与 Token 必须属于同一用户且 Token 未过期，否则返回 HTTP 401。
多进程部署：Token 已保存在数据库中；若在旧版本曾出现「部分请求 401」，多为多 Gunicorn worker 下内存 Token 不同步导致，升级并执行迁移后应消失。

请求

方法	`POST`
URL	`https://aifor1.com/api/open/v1/competitor-products/bulk-import/`
Content-Type	`multipart/form-data`

表单字段

字段名	必填	说明
`username`	是	登录用户名
`token`	是	个人中心生成的 API Token
`file` 或 `excel_file`	是	Excel 文件（`.xlsx` 等，与站内批量导入一致）
`category_id`	否	类目 ID（如 `MLM22576`）；不传则按空字符串写入，行为与站内「独立批量导入」一致

Excel 模板与必填列

与页面竞品商品批量导入要求一致：必填 skuId、商品名称；其余列与站内模板相同。

已存在的 skuId 会更新价格、销量等字段；不会因本接口而改变与产品款式的关联关系（与站内独立导入逻辑一致）。

成功响应 HTTP 200

JSON 示例：

{
  "success": true,
  "imported_count": 120,
  "skipped_count": 3,
  "message": "成功处理 120 条，跳过 3 条"
}

错误响应

401：用户名或 Token 无效 / 已过期
400：缺少文件、文件为空或 Excel 无法解析
500：服务端导入过程异常

响应体均为 JSON，含 success: false 与 error 说明。

调用示例（curl）

将 YOUR_USERNAME、YOUR_TOKEN、/path/to/data.xlsx 替换为实际值。

curl -X POST "https://aifor1.com/api/open/v1/competitor-products/bulk-import/" \
  -F "username=YOUR_USERNAME" \
  -F "token=YOUR_TOKEN" \
  -F "file=@/path/to/data.xlsx" \
  -F "category_id=MLM22576"

安全建议：生产环境请使用 HTTPS；勿在日志或前端代码中硬编码 Token。本接口设计为服务器间同步，若从浏览器跨域调用需自行配置 CORS（当前未默认开启）。