قاعدة المعرفة والمنتجات

زامن الأسئلة والأجوبة والمستندات والمنتجات دفعةً واحدة عبر API، وحدّثها تدريجيًا حسب المعرّف الخارجي.

4.1 قاعدة المعرفة

الطريقة	المسار	الوصف
POST	`/v1/knowledge/faqs/batch`	كتابة دفعة من الأسئلة والأجوبة، `{"items": [{"question", "answer", "external_id"}]}`، بحد أقصى 500 عنصر. تحديث تزايدي حسب `external_id`، ولن تتم إعادة معالجة المحتوى غير المتغيّر
POST	`/v1/knowledge/documents`	إضافة مستند: `{"title", "content"}` لتقديم النص مباشرةً، أو `{"url"}` لنقوم بجلب صفحة الويب. عند تضمين `external_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 الأسعار والمخزون من هذه القيم فقط.

هل كانت هذه الصفحة مفيدة؟

آخر تحديث: 31 أكتوبر 2026