真实接入Open API 已开放

开放接口接入

这里不做模拟接口。老板只负责生成交接包、确认是否创建 Key 和是否升级套餐；技术人员按包接入真实 Open API，所有写入仍停在内部草稿和人工审核队列。

可接接口

有效 Key

100/min

当前限流

Owner Checklist

老板只需要确认

是否允许外部系统接入当前工作区数据

是否创建新的 API Key，并只交给可信技术人员保存

是否升级到开放 Open API 的套餐

生产地址：https://commerce.topone-ai.cn

开放接口接入交接包

给技术人员或服务商的一键交接资料：接口清单、验收脚本、安全边界、Key 状态清单和上线检查表。包内不包含真实 API Key。

系统自动准备

接口清单、请求样例、验收脚本、交接说明

人必须确认

是否升级套餐、是否创建 Key、交给谁接入

绝不自动做

创建密钥、发布商品、改价、投放、发货、退款

已开放

Open API 状态

有效 API Key

包内真实密钥值

当前还没有有效 API Key。接入包会使用环境变量占位符；真实 Key 需要在下方由有权限的人手动创建，明文只显示一次。

Open API

已开放

当前计划：Pro

速率上限

100 次/分钟

有效 Key

共 0 条记录

需要人工确认：API Key

创建 Key 是真实授权动作，系统不会替你自动创建。明文只出现一次，确认接入对象可信后再创建。

Key 名称

名称	前缀	状态	最近使用	创建时间	操作
暂无 API Key。

高级接口明细

GET	/api/v1/products	读取当前工作区商品列表。
POST	/api/v1/products	创建内部商品草稿。
GET	/api/v1/products/{id}	读取当前工作区单个商品。
POST	/api/v1/ai/generate	为指定商品生成 Listing、视觉 Brief 或广告矩阵草稿。
POST	/api/v1/export	基于已审核 Listing 生成平台导出草稿。
GET	/api/v1/service/inbox	读取客服线程列表，可按 status、channel、platform、priority 查询。
GET	/api/v1/service/threads	读取客服线程列表。
POST	/api/v1/service/threads	写入外部客服消息，形成内部客服线程。
POST	/api/v1/service/drafts	为客服线程生成回复草稿。

示例（创建商品）：

curl -X POST https://commerce.topone-ai.cn/api/v1/products \
  -H "Authorization: Bearer $TOPONE_COMMERCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_name":"便携保温杯","category":"家居","price":129}'

所有响应统一为 { ok, data } / { ok, error:{ code, message } }。AI 生成与导出产物一律进入「待审核」，系统永不直接发布到外部平台。