وثائق واجهة برمجة التطبيقات (API)

نظرة عامة

توفر منصتنا واجهات برمجة تطبيقات (API) سهلة الاستخدام ومحسنة لتسهيل وصول عملاء ومساعدي الذكاء الاصطناعي إلى المنتجات والأسعار والتفاصيل التقنية للخدمات.

فحص حالة الخدمة والحصول على معلومات النظام الحالية.

الاستجابة الناجحة (200 OK)

{
  "status": "ok",
  "timestamp": 1780000000000,
  "uptime": 124.5,
  "env": "production"
}

مثال على الطلب (cURL)

curl -i https://www.shababalyola.ae/api/status

البحث في كتالوج المنتجات باستخدام عوامل تصفية مختلفة مثل اللون، الفئة، والموسم.

جسم الطلب (JSON)

{
  "query": "white emirati kandura",
  "category": "kandora",
  "color": "white",
  "season": "summer",
  "minPrice": 100,
  "maxPrice": 500,
  "limit": 5
}

الاستجابة الناجحة (200 OK)

{
  "ok": true,
  "count": 1,
  "items": [
    {
      "id": 12,
      "sku": "KND-WHT-SUMMER",
      "name": "Off-white Emirati Kandura",
      "price": 250,
      "discountedPrice": 220,
      "offerLabel": "12% OFF",
      "color": "white",
      "category": "kandora",
      "categorySlug": "kandora",
      "season": "summer",
      "subcategory": "emirati",
      "image": "https://pub-ce7da8061d0f411ba010b84ef5f6beb8.r2.dev/images/off-white.webp",
      "routePath": "/collections/kandora/off-white-emirati-kandura",
      "collectionPath": "/collections/kandora"
    }
  ]
}

مثال على الطلب (cURL)

curl -X POST https://www.shababalyola.ae/api/products/search \
  -H "Content-Type: application/json" \
  -d '{"query":"white kandura","limit":3}'

التفاعل مع مساعد الذكاء الاصطناعي عبر الرسائل المنسقة للحصول على ردود مخصصة.

جسم الطلب (JSON)

{
  "messages": [
    {
      "id": "msg-1",
      "role": "user",
      "content": "Do you have summer kanduras?"
    }
  ]
}

مثال على الطلب (cURL)

curl -X POST https://www.shababalyola.ae/api/chat \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"id":"m1","role":"user","content":"hello"}]}'