استخدام واجهة /api/v1
ابنوا واجهةً أمامية مخصّصة فوق API القراءة الخاصّ بالمنصّة.
ما هي
نقاط /api/v1 هي واجهة JSON للقراءة تخصّ مخزونكم ومحتواكم المنشور. استخدموها لتشغيل واجهة أمامية مخصّصة (Next.js أو Astro أو Nuxt)، أو تطبيق أصلي، أو شاشة كِيوسك في المعرض، أو أي جهة أخرى تحتاج بياناتكم.
هذه الصفحة موجَّهة لمن يبني ذلك المستهلك — عادةً مطوِّر. أمّا إن كنتم تريدون فقط إدارة السيارات والمحتوى، فواجهة الإدارة المدمجة تفي بالغرض.
المصادقة
أرسِلوا Authorization: Bearer <your_key> مع كل طلب. مفاتيح الخادم تعمل من أي مكان. مفاتيح النشر تحتاج إضافةً إلى ترويسة Origin تطابق القائمة التي حدّدتموها عند إنشاء المفتاح.
curl -H "Authorization: Bearer dlrb_sk_..." \
https://api.dealerbloom.com/api/v1/cars?make=BMW,Audi&pageSize=24
النقاط
GET /api/v1/cars— مخزون بترقيم صفحات مع فلاتر.GET /api/v1/cars/{slug}— التفاصيل الكاملة بما فيها الصور والمواصفات والفرع.GET /api/v1/makes— الماركات وموديلاتها.GET /api/v1/specs— مجموعات المواصفات وقيمها.GET /api/v1/locations— المعارض مع إحداثيات الخريطة.GET /api/v1/contact— الهواتف والواتساب والبريد وحسابات التواصل وساعات العمل.GET /api/v1/testimonials— آراء العملاء المنشورة.GET /api/v1/team— أعضاء الفريق المنشورون.GET /api/v1/content/{pageKey}— محتوى صفحة محدّدة.GET /api/v1/settings— اسم الموقع والشعار والعملة.
فلترة السيارات
الفلاتر متعدّدة القيم (make، model، color، spec_<slug>) تقبل قِيَماً مفصولة بفواصل أو مفاتيح استعلام متكرّرة. القيم داخل الفلتر الواحد تتحقّق إن انطبق أيّ منها؛ أمّا القيم في فلاتر مختلفة فيجب أن تنطبق كلّها معاً.
?make=BMW,Audi&model=A4,A6&color=black,white
?spec_body-type=SUV,Coupe&spec_fuel=Hybrid
# (BMW OR Audi) AND (A4 OR A6) AND (black OR white)
# AND (SUV OR Coupe) AND (Hybrid)
طلبات عبر النطاقات
الفحص المسبق للمتصفّح (OPTIONS) يمرّ دوماً. أمّا GET الفعلي فيتحقّق من مفتاح الحامل (Bearer)؛ ومفاتيح النشر تحتاج أيضاً مطابقة أحد النطاقات التي حدّدتموها عند إنشاء المفتاح.