Wissensdatenbank und Produkte

Synchronisieren Sie Fragen und Antworten, Dokumente und Produkte per API in Stapeln und aktualisieren Sie sie inkrementell anhand externer IDs.

4.1 Wissensdatenbank

Methode	Pfad	Beschreibung
POST	`/v1/knowledge/faqs/batch`	Fragen und Antworten im Batch schreiben, `{"items": [{"question", "answer", "external_id"}]}`, maximal 500 Einträge. Inkrementelle Aktualisierung nach `external_id`; unveränderte Inhalte werden nicht erneut verarbeitet
POST	`/v1/knowledge/documents`	Dokument hinzufügen: `{"title", "content"}` übergibt den Text direkt, oder `{"url"}` lässt uns die Webseite crawlen. Mit `external_id` wird das alte Dokument mit derselben ID ersetzt
POST	`/v1/knowledge/documents/upload`	Datei hochladen (multipart, Feld `file`), unterstützt txt, md, html, pdf, docx, maximal 20 MB
GET	`/v1/knowledge/documents`	Dokumentliste, `?page=&limit=&source_type=`
GET	`/v1/knowledge/documents/{id}`	Dokumentdetails, `status` ist `pending` / `processing` / `ready` / `failed`
DELETE	`/v1/knowledge/documents/{id}`	Löschen

Dokumente werden nach dem Schreiben asynchron verarbeitet und sind normalerweise innerhalb weniger Sekunden ready. Wenn ein Webhook konfiguriert ist, erhalten Sie document.ready oder document.failed.

4.2 Produkte

Methode	Pfad	Beschreibung
POST	`/v1/products/batch`	Batch-Schreiben, maximal 500 Einträge, inkrementelle Aktualisierung nach `external_id`
GET	`/v1/products`	Produktliste
DELETE	`/v1/products/{external_id}`	Löschen

Produktfelder:

{
  "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 mit null bedeutet, dass der Lagerbestand nicht verfolgt wird; Produkte mit status inactive werden nicht empfohlen. AI-Antworten zu Preisen und Lagerbeständen verwenden ausschließlich die hier angegebenen Werte.

War diese Seite hilfreich?

Zuletzt aktualisiert: 31. Oktober 2026