知識庫和商品
用 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 回答價格和庫存時只會使用這裡的值。
這頁對你有幫助嗎？
最後更新:
