知识库和商品
用 API 批量同步问答、文档和商品，按外部 ID 增量更新。
4.1 知识库
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/knowledge/faqs/batch | 批量写入问答，{"items": [{"question", "answer", "external_id"}]}，最多 500 条。按 external_id 增量更新，内容没变的不会重新处理 |
| POST | /v1/knowledge/documents | 新增文档：{"title", "content"} 直接给文本，或 {"url"} 由我们抓取网页。带 external_id 时替换同 ID 的旧文档 |
| POST | /v1/knowledge/documents/upload | 上传文件（multipart，字段 file），支持 txt、md、html、pdf、docx，最大 20MB |
| GET | /v1/knowledge/documents | 文档列表，?page=&limit=&source_type= |
| GET | /v1/knowledge/documents/{id} | 文档详情，status 为 pending / processing / ready / failed |
| DELETE | /v1/knowledge/documents/{id} | 删除 |
文档写入后异步处理，通常几秒内变成 ready。配置了 webhook 的话会收到 document.ready 或 document.failed。
4.2 商品
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/products/batch | 批量写入，最多 500 条，按 external_id 增量更新 |
| GET | /v1/products | 商品列表 |
| DELETE | /v1/products/{external_id} | 删除 |
商品字段：
{
"external_id": "w-1001",
"name": "潜水自动机械表",
"description": "200 米防水，蓝宝石表镜",
"category": "手表",
"price": "399.00",
"currency": "USD",
"stock": 12,
"url": "https://shop.example.com/p/w-1001",
"image_url": "https://shop.example.com/img/w-1001.jpg",
"attributes": {"材质": "316L 钢", "表径": "39 mm"},
"variants": [{"sku": "w-1001-blk", "name": "黑色", "price": "399.00", "stock": 5}],
"status": "active"
}
stock 为 null 表示不跟踪库存；status 为 inactive 的商品不会被推荐。AI 回答价格和库存只用这里的值。
这篇文档有帮助吗？
最后更新:
