Qingpu 渠道草稿库 API
本文档说明 Qingpu 铺货工作台的渠道草稿库接口。该列表读取 qingpu_listing_channel_drafts,且只返回 deleted_at is null 的有效草稿行。
初始化步骤
- 配置
QINGPU_DATABASE_URL,或者直接复用DATABASE_URL。 - 执行
app/themes/qingpu/database/listing.sql中的建表 SQL。 - 通过
/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
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
page | number | 否 | 页码,从 1 开始,默认 1。 |
limit | number | 否 | 每页条数,默认 50,最大 100。 |
search | string | 否 | 按商品标题或来源商品 ID 搜索。 |
showDeleted | boolean | 否 | 传 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中对应的草稿行。 - 不会影响货源商品和工作区行。