{"openapi":"3.1.0","info":{"title":"Injaz Store & Platform Developer API","version":"1.0.0","description":"واجهة برمجة التطبيقات المقسّمة لمنظومة إنجاز (المنتجات، الطلبات، الكوبونات، الثيمات، ومندوبي التوصيل)."},"components":{"securitySchemes":{"BearerApiKey":{"type":"http","scheme":"bearer","bearerFormat":"injaz_live_<token>","description":"مفتاح API الصادر من لوحة التاجر (/account/addons/webhooks)"}}},"security":[{"BearerApiKey":[]}],"paths":{"/api/v1/store/products":{"get":{"tags":["Catalog"],"summary":"جلب قائمة المنتجات والمخزون الحي","description":"يتطلب نطاق الصلاحية products:read. يعيد الأصناف النشطة وأسعارها وكمياتها المتاحة.","responses":{"200":{"description":"قائمة المنتجات بنجاح"},"401":{"description":"مفتاح غير صالح"}}}},"/api/v1/store/orders":{"get":{"tags":["Orders"],"summary":"جلب طلبات المتجر الإلكتروني ومنيو QR","description":"يتطلب نطاق الصلاحية orders:read. يعيد أحدث 100 طلب بحالاتها وكوبوناتها وإجمالياتها.","responses":{"200":{"description":"قائمة الطلبات بنجاح"},"401":{"description":"مفتاح غير صالح"}}}},"/api/v1/store/coupons":{"get":{"tags":["Marketing"],"summary":"جلب أكواد الخصم وإحصاءات المسوّقين","description":"يتطلب نطاق الصلاحية orders:read. يعيد الكوبونات ومرات الاستخدام وإجمالي المبيعات المحققة.","responses":{"200":{"description":"قائمة الكوبونات بنجاح"}}}},"/api/v1/store/themes":{"get":{"tags":["Themes & Builder"],"summary":"جلب إعدادات الثيم النشط وأقسام المحرر المرئي (JSON)","description":"يُستخدم من قبل مطوري الثيمات والتطبيقات المخصّصة (Headless Storefront).","responses":{"200":{"description":"بنية الثيم والأقسام"}}}},"/api/v1/store/drivers":{"get":{"tags":["Shipping & Drivers"],"summary":"جلب قائمة مندوبي التوصيل النشطين","description":"يتطلب نطاق الصلاحية orders:read.","responses":{"200":{"description":"قائمة المندوبين"}}}}}}