Qingpu 渠道草稿库 API

本文档说明 Qingpu 铺货工作台的渠道草稿库接口。该列表读取 qingpu_listing_channel_drafts,且只返回 deleted_at is null 的有效草稿行。

初始化步骤

  1. 配置 QINGPU_DATABASE_URL,或者直接复用 DATABASE_URL。
  2. 执行 app/themes/qingpu/database/listing.sql 中的建表 SQL。
  3. 通过 /api/qingpu/listing/channels* 调用渠道草稿库接口。

存储约定

  • 渠道草稿行存放在 qingpu_listing_channel_drafts。
  • deleted_at 是草稿删除态的权威字段。
  • 重新生成或重新提交草稿时,服务端会把 deleted_at 清回 null。
  • 当前渠道草稿库页面只展示默认 Ozon 模板行:channel='ozon' 且 store_key=''。

1. 获取渠道草稿列表

  • 请求地址: /api/qingpu/listing/channels?page=1&limit=50&search=
  • 请求方法: GET
  • 权限要求: 已登录用户或 Bearer 租户 Key

查询参数

参数类型必填说明
pagenumber否页码,从 1 开始,默认 1。
limitnumber否每页条数,默认 50,最大 100。
searchstring否按商品标题或来源商品 ID 搜索。
showDeletedboolean否传 true 时,列表会把已软删的渠道草稿一并返回。

成功响应

{
  "code": 0,
  "data": {
    "items": [
      {
        "productId": "p_123",
        "title": "Storage Box",
        "mainImageUrl": "https://example.com/image.png",
        "skuCount": 3,
        "categoryName": "Home Storage",
        "preprocessStatus": "generated",
        "updatedAt": "2026-07-20T12:00:00.000Z",
        "draft": {
          "channel": "ozon",
          "ready": true,
          "errors": [],
          "steps": [
            { "key": "translate", "done": true },
            { "key": "copy", "done": true },
            { "key": "images", "done": true },
            { "key": "category", "done": true }
          ],
          "checkedAt": "2026-07-20T11:58:00.000Z"
        }
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 50
  }
}

2. 删除渠道草稿

  • 请求地址: /api/qingpu/listing/channels/delete
  • 请求方法: POST
  • 权限要求: 已登录用户或 Bearer 租户 Key

请求体

{
  "productId": "p_123",
  "channel": "ozon"
}

成功响应

{
  "code": 0,
  "data": {
    "deletedCount": 1
  }
}

说明

  • 该接口不会物理删除草稿行。
  • 服务端会把 qingpu_listing_channel_drafts.deleted_at 更新为当前时间。
  • 后续重新跑草稿提交流程时,可以重新激活或重建该草稿行。

3. 恢复渠道草稿

  • 请求地址: /api/qingpu/listing/channels/restore
  • 请求方法: POST
  • 权限要求: 已登录用户或 Bearer 租户 Key

请求体

{
  "productId": "p_123",
  "channel": "ozon"
}

成功响应

{
  "code": 0,
  "data": {
    "restoredCount": 1
  }
}

说明

  • 该接口会把 qingpu_listing_channel_drafts.deleted_at 清回 null。
  • 如果前端希望把已删草稿显示出来,可在列表接口上传 showDeleted=true。

4. 永久删除渠道草稿

  • 请求地址: /api/qingpu/listing/channels/purge
  • 请求方法: POST
  • 权限要求: 已登录用户或 Bearer 租户 Key

请求体

{
  "productId": "p_123",
  "channel": "ozon"
}

成功响应

{
  "code": 0,
  "data": {
    "deletedCount": 1
  }
}

说明

  • 该接口只对已经处于软删态的渠道草稿生效。
  • 服务端会物理删除 qingpu_listing_channel_drafts 中对应的草稿行。
  • 不会影响货源商品和工作区行。