عروض الأسعار
POST /quotes يُرجع عرض سعر للتوصيل باستخدام مسافة التوجيه وبطاقة الأسعار. العروض متزامنة ويُفضل طلبها قبل عرض رسوم التوصيل أو إرسال الطلب.
الطلب
مطلوب: pickup وdropoff مع lat وlng. address اختياري. vehicle_type اختياري (مثل motorcycle، car).
{
"pickup": {"lat": 24.7136, "lng": 46.6753},
"dropoff": {"lat": 24.768, "lng": 46.709},
"vehicle_type": "motorcycle"
}
الاستجابة
| الحقل | المعنى |
|---|---|
quote_id | ULID للربط في POST /orders |
total_sar | السعر الإجمالي بالريال |
distance_km / duration_minutes | تقديرات التوجيه |
expires_at | وقت انتهاء الصلاحية (~15 دقيقة) |
breakdown | الرسوم الأساسية والكيلومترات الإضافية |
ربط العروض بالطلبات
مرّر quote_id عند إنشاء الطلب لتثبيت السعر.
الأخطاء
| الحالة | متى |
|---|---|
503 | مزود التسعير غير متاح — أعد المحاولة |
422 | إحداثيات أو حمولة غير صالحة |
401 / 403 | مصادقة أو قائمة IP |
Webhook
قد يُرسل quote.created إذا اشتركت في أحداث العروض.