تخطَّ إلى المحتوى
prebroTrade OS

PUBLIC API · v1.0

واجهة برمجية مفتوحة

اربط تطبيقك بسوق بريبرو — نقاط نهاية REST عامة للمنتجات، طلبات التسعير، وتتبع الشحنات. بدون مصادقة، JSON خالص.

Base URL

https://prebro.chat/api/v1

جميع الاستجابات JSON. CORS مُفعّل لجميع المصادر. حدود معقولة على caching للحفاظ على الأداء.

GET/api/v1/products

قائمة المنتجات

استعرض المنتجات النشطة من جميع المتاجر أو متجر محدد.

المعاملات

  • storeslug المتجر (اختياري)
  • qبحث في العنوان (اختياري)
  • limitعدد النتائج (افتراضي 20، حد أقصى 100)
  • offsetإزاحة (افتراضي 0)

مثال

curl https://prebro.chat/api/v1/products?store=demo&limit=10
GET/api/v1/rfqs

طلبات التسعير المفتوحة

استعرض طلبات التسعير النشطة في السوق.

المعاملات

  • countryكود الدولة (اختياري)
  • statusopen, awarded, closed
  • limitعدد النتائج

مثال

curl "https://prebro.chat/api/v1/rfqs?country=EG&status=open"
GET/api/v1/tracking/{trackingNumber}

تتبع شحنة

احصل على معلومات الشحنة وأحداثها بدون مصادقة.

المعاملات

  • trackingNumberرقم التتبع (من ضمن المسار)

مثال

curl https://prebro.chat/api/v1/tracking/TRK123456
GET/api/v1/stores/{slug}

معلومات متجر

بيانات عامة عن المتجر.

المعاملات

  • slugslug المتجر

مثال

curl https://prebro.chat/api/v1/stores/demo

حدود الاستخدام

  • • القراءة فقط (GET) — لا تتطلب مفاتيح API.
  • • caching على CDN: 1-5 دقائق حسب نقطة النهاية.
  • • حد أقصى 100 نتيجة لكل طلب — استخدم pagination عبر offset.
  • • للوصول للكتابة (إنشاء طلبات، عروض)، استخدم Supabase Client مع مصادقة المستخدم.