Merchant guide

后台操作帮助

面向日常运营人员；不需要理解服务器目录或图片路径。

返回运营后台

一、商品图片放在哪里

后台名称网站显示位置建议
主图商品列表缩略图、商品详情页第一张白底正方形，至少 800×800 像素
附图商品详情页的轮播图，排在主图后面展示侧面、细节、尺寸和使用场景

操作步骤

  1. 进入“商品与审核”，新建商品或点击某一商品的“编辑”。
  2. 在“商品图片”中点击“选择主图”；需要更多展示图时点击“选择附图”。
  3. 点击“保存工作版本”。系统会自动上传并保存图片地址。
  4. 按“提交审核 → 批准 → 标记发布”完成商品审核；最后创建一次站点发布。

后台不再要求商家填写“本地图片路径、远程主图、来源、图片列表”等技术字段。

二、创建站点发布

  1. 点击“商品与审核”右上角的“创建站点发布”，或进入“发布与回滚”点击“创建新发布”。
  2. 填写至少 5 个字符的发布说明，例如“发布 8 月新品与价格调整”。
  3. 生产环境按提示输入 MFA 动态码，本地测试环境可留空。
  4. 点击“确认创建发布”。任务进入队列后可在发布列表查看状态。

发布构建失败时，当前线上版本不会被替换。只有构建和校验全部成功后才会自动切换。

三、技术人员：图片 API 对接

日常运营无需使用 API。只有 ERP/PIM 批量同步商品时才需要本节。完整说明也保存在项目根目录的 ADMIN-OPERATION-AND-API-GUIDE.md。

上传主图

POST /admin/api/products/{商品ID}/image?version={当前版本号}&placement=main
Content-Type: multipart/form-data
file: 图片文件

上传附图

POST /admin/api/products/{商品ID}/image?version={当前版本号}&placement=gallery
Content-Type: multipart/form-data
file: 图片文件
  • placement=main 会替换商品主图，并把它放在轮播第一张。
  • placement=gallery 只追加详情附图，不改变主图。
  • 每次上传都会返回新的 version；连续上传必须使用上一次返回的版本号。
  • 允许 JPG、PNG、WebP、GIF，单张最大 5 MB。接口需要管理员登录会话、权限与 CSRF 请求头。