للمطوّرين

وثائق B2B API

واجهة B2B API خلف nwp.ae: سعّر واحجز لعملائك بالسعر الصافي، وأصدر القسائم، وأدِر مكتب فندق ونقل الشركات وبرامج شركات إدارة الوجهات، مع أسعارك وكشوف حسابك وفواتيرك في المكان نفسه. وصول مبكر: مفاتيح الاختبار تردّ ببيانات اختبارية موسومة، والمفاتيح الفعلية تُصدر عند الاعتماد.

الحالةوصول مبكر · بيئة الاختبار فقط

تفحص بيئة الاختبار الطلبات الحقيقية وفق المخطط الحقيقي وتردّ ببيانات اختبارية. لا يُحجز شيء، ولا تُحجز أي مركبة، ولا يُعاد أي سعر. لا تتضمن بيئة الاختبار أي التزام بمستوى الخدمة، وتُصدر مفاتيح الإنتاج للشركاء المعتمدين عند فتح واجهة API.

طلب وصول مبكر

نظرة عامة

JSON عبر HTTPS. أرسلوا Content-Type: application/json. كل رد بصيغة JSON ويحمل ترويسة x-request-id لذكرها لمكتب الوكالات؛ كما تحمل ردود بيئة الاختبار x-nwp-environment: sandbox.

عنوان URL الأساسي	—
بيئة الاختبار	`https://nwp.ae/api/b2b/sandbox`
بيئة الإنتاج	`https://nwp.ae/api/b2b/v1`غير متاحة بعد · يتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

واجهة B2B API v1

واجهة برمجية واحدة لكل ما يقوم به الحساب: النقل البري والجولات والأنشطة مسعّرة وفق شروطك التجارية (سعر صافٍ أو عمولة أو تعرفة)، وحجوزات عملائك، والقسائم ولوحات الأسماء، ومكتب الفندق، ونقل الشركات، وبرامج شركات إدارة الوجهات، وأداة الحجز، والمستخدمون، والإشعارات، وكشوف الحساب والفواتير. مفاتيح الاختبار (nwp_test_…) متاحة للمتقدمين: تجيب على كل نقطة ببيانات تجريبية موسومة sandbox: true ولا تحجز أبداً ولا تغيّر حسابك. المفاتيح الفعلية (nwp_live_…) تُصدر عند الموافقة، وتعمل بعد أن تفعّل NWP الوصول الفعلي لحسابك. كل طلب POST يقبل Idempotency-Key، وكل رد يحمل x-request-id، ولكل مفتاح حدّه في الدقيقة.

مستند OpenAPI 3.1: /api/b2b/v1/openapi.json

النقل البري

POST/api/b2b/v1/transport/quote
التسعير وفق شروطك
النطاق: transport:read
POST/api/b2b/v1/transport/bookings
الحجز
النطاق: transport:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/transport/bookings/{id}
حالة الحجز وشروط الإلغاء
النطاق: transport:read
POST/api/b2b/v1/transport/bookings/{id}/cancel
الإلغاء وفق السياسة
النطاق: transport:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/transport/bookings/{id}/voucher
قسيمة باسمك التجاري (HTML أو PDF)
النطاق: transport:read

الجولات والأنشطة

GET/api/b2b/v1/activities/products
المنتجات المعروضة، للشخص أو للمركبة
النطاق: activities:read
GET/api/b2b/v1/activities/products/{id}/availability
التوافر يوماً بيوم
النطاق: activities:read
POST/api/b2b/v1/activities/quote
التسعير وفق شروطك
النطاق: activities:read
POST/api/b2b/v1/activities/bookings
الحجز
النطاق: activities:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/activities/bookings/{id}
حالة الحجز وشروط الإلغاء
النطاق: activities:read
POST/api/b2b/v1/activities/bookings/{id}/cancel
الإلغاء وفق السياسة
النطاق: activities:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/activities/bookings/{id}/voucher
قسيمة باسمك التجاري (HTML أو PDF)
النطاق: activities:read

الرحلات البحرية

GET/api/b2b/v1/cruise/sailings
الرحلات
النطاق: cruise:readغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
POST/api/b2b/v1/cruise/quote
التسعير وفق شروطك
النطاق: cruise:readغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
POST/api/b2b/v1/cruise/bookings
الحجز
النطاق: cruise:writeغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
GET/api/b2b/v1/cruise/bookings/{id}
حالة الحجز وشروط الإلغاء
النطاق: cruise:readغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
POST/api/b2b/v1/cruise/bookings/{id}/cancel
الإلغاء وفق السياسة
النطاق: cruise:writeغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية

أدلة الترحيب

GET/api/b2b/v1/guides/properties
عقاراتك
النطاق: guides:read
POST/api/b2b/v1/guides/properties
إضافة عقار
النطاق: guides:write
GET/api/b2b/v1/guides/properties/{id}
دليل العقار ورابطه وملفاته
النطاق: guides:read
PATCH/api/b2b/v1/guides/properties/{id}
تعديل عقار
النطاق: guides:write
POST/api/b2b/v1/guides/properties/{id}/status
إيقاف دليل أو استئنافه
النطاق: guides:write
POST/api/b2b/v1/guides/properties/{id}/link
استبدال رابط الضيوف
النطاق: guides:write
GET/api/b2b/v1/guides/properties/{id}/wifi
قراءة بيانات الواي فاي
النطاق: guides_wifi:read
POST/api/b2b/v1/guides/properties/{id}/wifi
ضبط الواي فاي
النطاق: guides_wifi:write
GET/api/b2b/v1/guides/properties/{id}/qr
رمز QR (PNG أو SVG)
النطاق: guides:read
GET/api/b2b/v1/guides/properties/{id}/card
بطاقة للطباعة (PDF أو HTML)
النطاق: guides:read
GET/api/b2b/v1/guides/stats
المسح والمشاهدات والحجوزات وحصتك
النطاق: guides:read

الحساب

GET/api/b2b/v1/whoami
فحص المفتاح
النطاق: account:read
GET/api/b2b/v1/openapi.json
هذه الواجهة بصيغة OpenAPI 3.1

المسوّقون بالعمولة

GET/api/b2b/v1/affiliate/stats
إحصاءات فترة محددة: النقرات والحجوزات ومعدل التحويل والأرباح
النطاق: affiliate:read
GET/api/b2b/v1/affiliate/links
روابط التتبع الخاصة بك، مع رموز QR
النطاق: affiliate:read
POST/api/b2b/v1/affiliate/links
إنشاء رابط تتبع مع معلمات UTM
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/affiliate/links/{code}/qr
رمز QR لرابط (SVG أو PNG)
النطاق: affiliate:read
GET/api/b2b/v1/affiliate/performance
النقرات والحجوزات والأرباح لكل رابط
النطاق: affiliate:read
GET/api/b2b/v1/affiliate/payouts
رصيد المستحقات وطلبات الصرف
النطاق: affiliate:read
POST/api/b2b/v1/affiliate/payouts
طلب صرف المستحقات، ويُرسل بتحويل مصرفي
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/affiliate/payouts/{reference}/cancel
التراجع عن طلب صرف
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/affiliate/bank-details
حفظ البيانات المصرفية (تُرسل فقط ولا تُعاد أبداً)
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/affiliate/widget
إعدادات الأداة ومقتطفها البرمجي
النطاق: affiliate:read
POST/api/b2b/v1/affiliate/widget
إعداد أداة الحجز
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

حجوزات عملائك

POST/api/b2b/v1/bookings/quote
التسعير وفق شروطك
النطاق: bookings:create
POST/api/b2b/v1/bookings
الحجز
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/bookings
القائمة
النطاق: bookings:view
GET/api/b2b/v1/bookings/credited
الحجوزات المحتسبة لحسابك
النطاق: bookings:view
GET/api/b2b/v1/bookings/{ref}
التفاصيل
النطاق: bookings:view
POST/api/b2b/v1/bookings/{ref}/cancel
الإلغاء وفق السياسة
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/bookings/{ref}/amendments
طلب تعديل من مكتب الوكالات
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/bookings/{ref}/brand
علامتك التجارية، أو بلا علامة، على مستنداته
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/bookings/{ref}/voucher
قسيمة باسمك التجاري (HTML أو PDF)
النطاق: bookings:view
GET/api/b2b/v1/bookings/{ref}/name-board
لوحة الاسم التي يحملها السائق (HTML)
النطاق: bookings:view
GET/api/b2b/v1/requests
طلبات التعديل والخدمة، مع ردود المكتب
النطاق: bookings:view
POST/api/b2b/v1/requests/{id}/withdraw
سحب طلب مفتوح
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

مكتب الفندق

POST/api/b2b/v1/desk/sales
البيع السريع من المكتب
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/desk/days/{date}
مبيعات يوم، أو تسويته بصيغة CSV أو PDF
النطاق: statements:read
POST/api/b2b/v1/desk/days/{date}/close
إقفال اليوم وتثبيت تسويته
النطاق: statements:readيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

نقل الشركات

GET/api/b2b/v1/corporate/cost-centres
القائمة
النطاق: bookings:view
POST/api/b2b/v1/corporate/cost-centres
الإنشاء أو التعديل
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/cost-centres/{id}/approvers
الإنشاء أو التعديل
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/corporate/requests
القائمة
النطاق: bookings:view
POST/api/b2b/v1/corporate/requests
الحجز
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/requests/{id}/decision
الموافقة أو الرفض
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/corporate/shuttles
القائمة
النطاق: bookings:view
POST/api/b2b/v1/corporate/shuttles
الإنشاء أو التعديل
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/shuttles/{id}/status
تغيير الحالة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/shuttles/{id}/schedule
جدولة رحلات شهر
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/shuttles/{id}/reprice
اعتماد سعر اتُّفق عليه حديثاً
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/corporate/usage
الاستخدام حسب مركز التكلفة (JSON أو CSV)
النطاق: statements:read

برامج DMC

GET/api/b2b/v1/dmc/programmes
القائمة
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes
الإنشاء أو التعديل
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/dmc/programmes/{id}
التفاصيل
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes/{id}/versions
حفظ نسخة مسعّرة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/dmc/programmes/{id}/status
تغيير الحالة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/dmc/programmes/{id}/brand
علامتك التجارية، أو بلا علامة، على مستنداته
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/dmc/programmes/{id}/accept
قبول نسخة وحجزها
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/dmc/programmes/{id}/proposal
عرض للعميل (HTML)
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes/{id}/links
إصدار رابط للعميل محدد المدة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/dmc/programmes/{id}/links
روابط العملاء ومن قبِلها
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes/{id}/links/{link}/revoke
إلغاء رابط عميل
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

الأسعار وطلبات عروض الأسعار

GET/api/b2b/v1/rates/catalogue
الكتالوج بأسعارك (JSON أو CSV أو PDF)
النطاق: rates:view
GET/api/b2b/v1/rates/sheet
جدول أسعار الخدمات
النطاق: rates:view
POST/api/b2b/v1/quote-requests
إرسال طلب عرض سعر
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/wholesale-requests
طلب سعة من المركبات
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

أداة الحجز

GET/api/b2b/v1/widget
إعدادات الأداة ومقتطفها البرمجي
النطاق: tracking:view
POST/api/b2b/v1/widget
تعديل الأداة
النطاق: tracking:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

المستخدمون

GET/api/b2b/v1/users
القائمة
النطاق: users:view
POST/api/b2b/v1/users
دعوة شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/users/{id}/role
تغيير دور شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/users/{id}/deactivate
إيقاف وصول شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/users/{id}/reactivate
استعادة وصول شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

الإشعارات

GET/api/b2b/v1/inbox
إشعارات تخص حسابك
النطاق: inbox:view

كشوف الحساب والفواتير

GET/api/b2b/v1/statements
كشوف الحساب والرصيد والفواتير المفتوحة
النطاق: statements:read
GET/api/b2b/v1/statements/{period}
كشف حساب شهر واحد (JSON أو PDF)
النطاق: statements:read
GET/api/b2b/v1/invoices/{id}
فاتورة واحدة (JSON أو PDF)
النطاق: statements:read

إعدادات الحساب

GET/api/b2b/v1/settings
بيانات الحساب وجهات الاتصال وبريد الفواتير
النطاق: settings:view
POST/api/b2b/v1/settings/billing-email
تحديد بريد الفواتير
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/settings/contacts
إضافة جهة اتصال أو تعديلها
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/settings/contacts/{id}/remove
حذف جهة اتصال
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/settings/brand
علامتك التجارية، أو بلا علامة، على مستنداته
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

POST /api/b2b/v1/transport/quote

curl -X POST 'https://nwp.ae/api/b2b/v1/transport/quote' \
  -H 'Authorization: Bearer nwp_test_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7f1c2b0e-quote-1' \
  -d '{"airport":"dxb","terminal":"t3","direction":"from_airport","place":"downtown","vehicle":"vclass","pickup_date":"2026-11-02","pickup_time":"14:30","passengers":3,"bags":3}'

المصادقة

كل استدعاء لبيئة الاختبار يتطلب رمز مصادقة (bearer token). تُصدره مصافحة المطوّر: رمز بصيغة JWT يبدأ بـ nwp_sandbox_، صالح لمدة 30 يوماً، ولا يفتح إلا البيانات الاختبارية.

1طلب رمز لبيئة الاختبار

POST /api/b2b/orchestration

curl -X POST https://nwp.ae/api/b2b/orchestration \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "developer_handshake",
    "platform_name": "Example Travel App",
    "contact_email": "developers@example.com",
    "use_case": "transfers"
  }'

201 Created

{
  "environment": "sandbox",
  "status": "early-access",
  "test_data": true,
  "token_type": "Bearer",
  "token": "nwp_sandbox_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImVudiI6InNhbmRib3gifQ…",
  "expires_at": "2026-10-31T08:00:00.000Z",
  "scopes": [
    "sandbox:transfers.quote",
    "sandbox:availability.read"
  ],
  "endpoints": [
    {
      "method": "POST",
      "url": "https://nwp.ae/api/b2b/sandbox/transfers"
    },
    {
      "method": "GET",
      "url": "https://nwp.ae/api/b2b/sandbox/availability"
    },
    {
      "method": "GET",
      "url": "https://nwp.ae/api/b2b/sandbox/status"
    }
  ],
  "production": {
    "status": "not_open",
    "request_access": "https://nwp.ae/register?type=institutional"
  }
}

2استدعاء بيئة الاختبار باستخدامه

POST /api/b2b/sandbox/transfers

curl -X POST https://nwp.ae/api/b2b/sandbox/transfers \
  -H 'Authorization: Bearer nwp_sandbox_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImVudiI6InNhbmRib3gifQ…' \
  -H 'Content-Type: application/json' \
  -d @transfer.json

طلب النقل

أرسلوا الحقول أدناه إلى نقطة نهاية النقل في بيئة الاختبار. أسماء الحقول جزء من واجهة API وتبقى بالإنجليزية في كل اللغات.

pickup_locationإلزامي: { type: "airport" | "coordinates" | "hotel", … }
مكان استقبال الراكب: مبنى ركاب في المطار (DXB_T1, DXB_T2, DXB_T3, DWC, SHJ)، أو إحداثيات داخل الإمارات، أو مرجع فندق.
dropoff_locationإلزامي: { type: "hotel" | "coordinates" | "airport", … }
المكان الذي يُنقل إليه الراكب: نص مرجعي للفندق (رمز الفندق لديكم أو اسم الفندق)، أو إحداثيات، أو مبنى ركاب في المطار.
flight_numberمشروط: string
الرحلة القادمة، مثل EK202. يُضبط موعد الاستقبال على موعد الهبوط المجدول للرحلة.
pickup_atمشروط: string (ISO 8601)
بصيغة ISO 8601 مع فارق التوقيت. إلزامي عندما لا يكون الاستقبال من مطار، أو عندما لا يكون لاستقبال المطار رقم رحلة.
buffer_minutes_overrideاختياري: integer
الانتظار المجاني بعد الهبوط، بالدقائق، من 0 إلى 180. القيمة الافتراضية 60: وهي مدة الانتظار المجاني التي يمنحها موقع النقل التابع للمجموعة لكل وصول.
vehicle_classإلزامي: enum
إحدى القيم: VIP_V_CLASS أو EXECUTIVE_SEDAN أو LUXURY_COACH.
passengersاختياري: integer
يُرفض إذا تجاوز عدد مقاعد الفئة.
client_metadataاختياري: object
تفاصيل العلامة البيضاء لقسيمة المسافر: agency_name و logo_url (عبر https فقط) و voucher_branding و agency_reference.

الحقل	النوع	إلزامي	الوصف
`pickup_location`	`{ type: "airport" \| "coordinates" \| "hotel", … }`	إلزامي	مكان استقبال الراكب: مبنى ركاب في المطار (DXB_T1, DXB_T2, DXB_T3, DWC, SHJ)، أو إحداثيات داخل الإمارات، أو مرجع فندق.
`dropoff_location`	`{ type: "hotel" \| "coordinates" \| "airport", … }`	إلزامي	المكان الذي يُنقل إليه الراكب: نص مرجعي للفندق (رمز الفندق لديكم أو اسم الفندق)، أو إحداثيات، أو مبنى ركاب في المطار.
`flight_number`	`string`	مشروط	الرحلة القادمة، مثل EK202. يُضبط موعد الاستقبال على موعد الهبوط المجدول للرحلة.
`pickup_at`	`string (ISO 8601)`	مشروط	بصيغة ISO 8601 مع فارق التوقيت. إلزامي عندما لا يكون الاستقبال من مطار، أو عندما لا يكون لاستقبال المطار رقم رحلة.
`buffer_minutes_override`	`integer`	اختياري	الانتظار المجاني بعد الهبوط، بالدقائق، من 0 إلى 180. القيمة الافتراضية 60: وهي مدة الانتظار المجاني التي يمنحها موقع النقل التابع للمجموعة لكل وصول.
`vehicle_class`	`enum`	إلزامي	إحدى القيم: VIP_V_CLASS أو EXECUTIVE_SEDAN أو LUXURY_COACH.
`passengers`	`integer`	اختياري	يُرفض إذا تجاوز عدد مقاعد الفئة.
`client_metadata`	`object`	اختياري	تفاصيل العلامة البيضاء لقسيمة المسافر: agency_name و logo_url (عبر https فقط) و voucher_branding و agency_reference.

transfer.json

{
  "pickup_location": {
    "type": "airport",
    "terminal": "DXB_T3"
  },
  "dropoff_location": {
    "type": "hotel",
    "hotel_ref": "EXAMPLE-HOTEL-DOWNTOWN"
  },
  "flight_number": "EK202",
  "buffer_minutes_override": 60,
  "vehicle_class": "VIP_V_CLASS",
  "passengers": 4,
  "client_metadata": {
    "agency_name": "Example Travel",
    "logo_url": "https://example.com/logo.png",
    "voucher_branding": {
      "mode": "white_label",
      "accent_hex": "#0A0A0A"
    },
    "agency_reference": "EX-10442"
  }
}

فئات المركبات

الفئة	المركبة	المقاعد
`VIP_V_CLASS`	Mercedes-Benz V-Class or similar	7
`EXECUTIVE_SEDAN`	Lexus ES 350 or a similar executive saloon	3
`LUXURY_COACH`	Toyota Coaster or King Long coach	30

تُستأجر كل مركبة مع سائقها المرخّص للمهمة؛ وتحدد الفئة نوع المركبة وعدد مقاعدها.

الرد

يعيد عرض السعر في بيئة الاختبار الطلبَ نفسه ويضيف كيفية توقيت الاستقبال وكيفية وسم القسيمة بالعلامة التجارية. ولا يتضمن أي سعر أبداً.

200 OK

{
  "environment": "sandbox",
  "test_data": true,
  "notice": "Sandbox response: test data only. Nothing is booked, no vehicle is held and no price is quoted. Production is not open yet.",
  "quote_id": "SBX-WT5PCXWF",
  "status": "sandbox_accepted",
  "vehicle": {
    "class": "VIP_V_CLASS",
    "description": "Mercedes-Benz V-Class or similar",
    "max_passengers": 7
  },
  "passengers": 4,
  "pickup": {
    "location": {
      "type": "airport",
      "terminal": "DXB_T3"
    },
    "timing": {
      "mode": "flight_landing",
      "flight_number": "EK202",
      "driver_ready": "at the scheduled landing time",
      "free_waiting_minutes": 60,
      "live_arrival_tracking": "planned"
    }
  },
  "dropoff": {
    "location": {
      "type": "hotel",
      "hotel_ref": "EXAMPLE-HOTEL-DOWNTOWN"
    }
  },
  "voucher": {
    "branding": "white_label",
    "agency_name": "Example Travel",
    "logo_url": "https://example.com/logo.png",
    "accent_hex": "#0A0A0A",
    "footer_text": null,
    "agency_reference": "EX-10442",
    "shows_nwp_branding": false
  },
  "price": null,
  "price_note": "Sandbox quotes carry no price. Net rates are issued to approved partners in the portal.",
  "default_buffer_minutes": 60,
  "created_at": "2026-10-01T08:00:00.000Z"
}

422 Unprocessable Entity

{
  "error": {
    "code": "validation_failed",
    "message": "One or more fields are invalid.",
    "retryable": false,
    "fields": [
      "flight_number"
    ],
    "issues": [
      {
        "path": "flight_number",
        "message": "flight_number must be an airline flight number such as EK202."
      }
    ]
  },
  "environment": "sandbox"
}

توقيت الرحلات

حالياً يُضبط موعد الاستقبال على وقت الهبوط المسجّل في الحجز، وينتظر السائق مجاناً طوال مدة المهلة بعده. إذا تغيّر موعد الرحلة، أبلغوا مكتب الوكالات فيتغيّر موعد الاستقبال معه.

التتبّع الآلي المباشر للوصول عبر FlightAware أو AeroDataBox مُخطَّط له. لم يُربط أيٌّ منهما بعد، وتُظهر بيئة الاختبار live_arrival_tracking بحالة «مُخطَّط له» (planned).

التوفر الموقَّع

تعيد المصافحة عنوان URL موقَّعاً للتوفر. يغطي التوقيع التاريخ وفئة المركبة وموعد الانتهاء؛ وإذا غيّرتم أياً منها يُرفض الاستدعاء. الحالات عيّنات للبناء عليها.

GET /api/b2b/sandbox/availability

curl 'https://nwp.ae/api/b2b/sandbox/availability?date=2026-10-15&vehicle_class=VIP_V_CLASS&expires=1760572800&sig=…'

200 OK

{
  "environment": "sandbox",
  "test_data": true,
  "notice": "Sandbox response: test data only. Nothing is booked, no vehicle is held and no price is quoted. Production is not open yet.",
  "date": "2026-10-15",
  "vehicle_class": "VIP_V_CLASS",
  "vehicle": {
    "description": "Mercedes-Benz V-Class or similar",
    "max_passengers": 7
  },
  "sample_status": "on_request",
  "note": "A sample status for building against. Real availability is confirmed by the trade desk until the API opens."
}

إجراءات الحساب

أرسلوا طلب POST إلى نقطة نهاية التنسيق مع إجراء. أي إجراء يطلب من شخص القيام بشيء يُخزَّن ويُحال إلى مكتب الوكالات قبل أن يُشير الرد إلى ذلك.

الإجراء	ما يفعله
`credit_line_application`	شروط Net-15 أو 30 أو 45 أو 60 لشركة مسجّلة في الإمارات. رقم الرخصة التجارية ورقم TRN (15 رقماً، يبدأ بـ 100) مطلوبان. يراجع موظف كل طلب، وتكون الحجوزات مدفوعة مسبقاً إلى أن يُعتمد خط ائتمان.
`wallet_topup`	دفعة مسبقة إلى حسابكم. الشحن بالبطاقة غير متاح بعد، لذا يرسل إليكم مكتب الوكالات فاتورة للدفع بتحويل بنكي، ويشير الرد إلى ذلك.
`account_payload`	مصفوفة العملات لحسابكم. AED هي العملة الأساسية والعملة الوحيدة التي يُحتسب بها أي مبلغ مدفوع أو مكتسب؛ والعملات الأخرى تحويلات للعرض بالسعر اليومي للموقع، فلا يتغيّر الهامش أبداً بالتحويل.
`tracking_link`	رابط شريك حتمي ورمز QR لمستويي بيوت العطلات والمسوّقين بالعمولة، مع بيان واضح بالجهة التي يُنسب إليها حالياً.
`developer_handshake`	رمز لبيئة الاختبار، ونقاط نهاية بيئة الاختبار، وعنوان URL موقَّع للتوفر.

action: credit_line_application

{
  "action": "credit_line_application",
  "company_legal_name": "Example Travel L.L.C.",
  "trade_licence_number": "1234567",
  "licence_authority": "Department of Economy and Tourism, Dubai",
  "trn": "100000000000003",
  "contact_name": "Finance Desk",
  "contact_email": "finance@example.com",
  "requested_terms": "NET_30",
  "requested_limit_aed": 50000
}

action: wallet_topup

{
  "action": "wallet_topup",
  "company_name": "Example Travel L.L.C.",
  "contact_email": "finance@example.com",
  "amount_aed": 10000,
  "purchase_order": "PO-2291"
}

action: account_payload

{
  "action": "account_payload",
  "company_name": "Example Travel L.L.C.",
  "tier": "Tier_4_Regional_DMCs",
  "display_currencies": [
    "USD",
    "EUR"
  ],
  "lines": [
    {
      "label": "Your own city-tour package",
      "net_aed": 400,
      "sell_aed": 560
    }
  ]
}

action: tracking_link

{
  "action": "tracking_link",
  "partner_code": "HHO-EXAMPLE",
  "tier": "Tier_1_Holiday_Homes",
  "property_id": "marina-2104",
  "destination": "dubaitransfers.ae"
}

الأخطاء

لكل خطأ الشكل نفسه: error.code و error.message و error.retryable، مع fields و issues عند فشل التحقق.

الحالة	الرمز	المعنى
400	`invalid_json`	نص الطلب ليس JSON صالحاً.
401	`unauthenticated`	لا يوجد رمز لبيئة الاختبار، أو الرمز مشوّه أو منتهي الصلاحية أو موقَّع بشكل خاطئ.
404	`not_found`	نقطة النهاية غير موجودة على هذا الخادم.
405	`method_not_allowed`	نقطة النهاية تقبل طريقة أخرى.
413	`payload_too_large`	نص الطلب أكبر من 16 KB.
422	`validation_failed`	حقل مفقود أو مشوّه: راجعوا fields و issues.
429	`rate_limited`	طلبات كثيرة جداً من هذا العنوان: أعيدوا المحاولة بعد retry_after_seconds.
500	`internal`	حدث خطأ من جهتنا: اذكروا معرّف الطلب.
502	`upstream_unavailable`	لم يستجب مزوّد الدفع.
503	`not_configured`	تعذّر تخزين الطلب: راسلوا مكتب الوكالات بالبريد الإلكتروني.

حدود المعدل

إجراءات الحساب محدودة لكل عنوان في الساعة: credit_line_application: 5 وwallet_topup: 10 وaccount_payload: 60 وtracking_link: 60 وdeveloper_handshake: 10. واستدعاءات بيئة الاختبار محدودة بـ 120 في الساعة لكل عنوان.

أداة الحجز مفتوحة للشركاء المعتمدين ضمن الوصول المبكر: وسم برمجي واحد يضع جولات nwp.ae وتنقلاتها على موقعك بالسعر العام، باثنتي عشرة لغة، وباسمك، مع رمز الشريك على كل حجز. اضبطها عبر واجهة API: نقاط أداة الحجز تقرأ إعداداتها وتغيّرها وتعيد المقتطف البرمجي الذي تلصقه في موقعك.

للمطوّرين

وثائق B2B API

الحالةوصول مبكر · بيئة الاختبار فقط

طلب وصول مبكر

نظرة عامة

عنوان URL الأساسي	—
بيئة الاختبار	`https://nwp.ae/api/b2b/sandbox`
بيئة الإنتاج	`https://nwp.ae/api/b2b/v1`غير متاحة بعد · يتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

واجهة B2B API v1

مستند OpenAPI 3.1: /api/b2b/v1/openapi.json

النقل البري

POST/api/b2b/v1/transport/quote
التسعير وفق شروطك
النطاق: transport:read
POST/api/b2b/v1/transport/bookings
الحجز
النطاق: transport:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/transport/bookings/{id}
حالة الحجز وشروط الإلغاء
النطاق: transport:read
POST/api/b2b/v1/transport/bookings/{id}/cancel
الإلغاء وفق السياسة
النطاق: transport:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/transport/bookings/{id}/voucher
قسيمة باسمك التجاري (HTML أو PDF)
النطاق: transport:read

الجولات والأنشطة

GET/api/b2b/v1/activities/products
المنتجات المعروضة، للشخص أو للمركبة
النطاق: activities:read
GET/api/b2b/v1/activities/products/{id}/availability
التوافر يوماً بيوم
النطاق: activities:read
POST/api/b2b/v1/activities/quote
التسعير وفق شروطك
النطاق: activities:read
POST/api/b2b/v1/activities/bookings
الحجز
النطاق: activities:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/activities/bookings/{id}
حالة الحجز وشروط الإلغاء
النطاق: activities:read
POST/api/b2b/v1/activities/bookings/{id}/cancel
الإلغاء وفق السياسة
النطاق: activities:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/activities/bookings/{id}/voucher
قسيمة باسمك التجاري (HTML أو PDF)
النطاق: activities:read

الرحلات البحرية

GET/api/b2b/v1/cruise/sailings
الرحلات
النطاق: cruise:readغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
POST/api/b2b/v1/cruise/quote
التسعير وفق شروطك
النطاق: cruise:readغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
POST/api/b2b/v1/cruise/bookings
الحجز
النطاق: cruise:writeغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
GET/api/b2b/v1/cruise/bookings/{id}
حالة الحجز وشروط الإلغاء
النطاق: cruise:readغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية
POST/api/b2b/v1/cruise/bookings/{id}/cancel
الإلغاء وفق السياسة
النطاق: cruise:writeغير متاح بعد: يجيب 501 حتى يُربط مزوّد رحلات بحرية

أدلة الترحيب

GET/api/b2b/v1/guides/properties
عقاراتك
النطاق: guides:read
POST/api/b2b/v1/guides/properties
إضافة عقار
النطاق: guides:write
GET/api/b2b/v1/guides/properties/{id}
دليل العقار ورابطه وملفاته
النطاق: guides:read
PATCH/api/b2b/v1/guides/properties/{id}
تعديل عقار
النطاق: guides:write
POST/api/b2b/v1/guides/properties/{id}/status
إيقاف دليل أو استئنافه
النطاق: guides:write
POST/api/b2b/v1/guides/properties/{id}/link
استبدال رابط الضيوف
النطاق: guides:write
GET/api/b2b/v1/guides/properties/{id}/wifi
قراءة بيانات الواي فاي
النطاق: guides_wifi:read
POST/api/b2b/v1/guides/properties/{id}/wifi
ضبط الواي فاي
النطاق: guides_wifi:write
GET/api/b2b/v1/guides/properties/{id}/qr
رمز QR (PNG أو SVG)
النطاق: guides:read
GET/api/b2b/v1/guides/properties/{id}/card
بطاقة للطباعة (PDF أو HTML)
النطاق: guides:read
GET/api/b2b/v1/guides/stats
المسح والمشاهدات والحجوزات وحصتك
النطاق: guides:read

الحساب

GET/api/b2b/v1/whoami
فحص المفتاح
النطاق: account:read
GET/api/b2b/v1/openapi.json
هذه الواجهة بصيغة OpenAPI 3.1

المسوّقون بالعمولة

GET/api/b2b/v1/affiliate/stats
إحصاءات فترة محددة: النقرات والحجوزات ومعدل التحويل والأرباح
النطاق: affiliate:read
GET/api/b2b/v1/affiliate/links
روابط التتبع الخاصة بك، مع رموز QR
النطاق: affiliate:read
POST/api/b2b/v1/affiliate/links
إنشاء رابط تتبع مع معلمات UTM
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/affiliate/links/{code}/qr
رمز QR لرابط (SVG أو PNG)
النطاق: affiliate:read
GET/api/b2b/v1/affiliate/performance
النقرات والحجوزات والأرباح لكل رابط
النطاق: affiliate:read
GET/api/b2b/v1/affiliate/payouts
رصيد المستحقات وطلبات الصرف
النطاق: affiliate:read
POST/api/b2b/v1/affiliate/payouts
طلب صرف المستحقات، ويُرسل بتحويل مصرفي
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/affiliate/payouts/{reference}/cancel
التراجع عن طلب صرف
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/affiliate/bank-details
حفظ البيانات المصرفية (تُرسل فقط ولا تُعاد أبداً)
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/affiliate/widget
إعدادات الأداة ومقتطفها البرمجي
النطاق: affiliate:read
POST/api/b2b/v1/affiliate/widget
إعداد أداة الحجز
النطاق: affiliate:writeيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

حجوزات عملائك

POST/api/b2b/v1/bookings/quote
التسعير وفق شروطك
النطاق: bookings:create
POST/api/b2b/v1/bookings
الحجز
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/bookings
القائمة
النطاق: bookings:view
GET/api/b2b/v1/bookings/credited
الحجوزات المحتسبة لحسابك
النطاق: bookings:view
GET/api/b2b/v1/bookings/{ref}
التفاصيل
النطاق: bookings:view
POST/api/b2b/v1/bookings/{ref}/cancel
الإلغاء وفق السياسة
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/bookings/{ref}/amendments
طلب تعديل من مكتب الوكالات
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/bookings/{ref}/brand
علامتك التجارية، أو بلا علامة، على مستنداته
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/bookings/{ref}/voucher
قسيمة باسمك التجاري (HTML أو PDF)
النطاق: bookings:view
GET/api/b2b/v1/bookings/{ref}/name-board
لوحة الاسم التي يحملها السائق (HTML)
النطاق: bookings:view
GET/api/b2b/v1/requests
طلبات التعديل والخدمة، مع ردود المكتب
النطاق: bookings:view
POST/api/b2b/v1/requests/{id}/withdraw
سحب طلب مفتوح
النطاق: bookings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

مكتب الفندق

POST/api/b2b/v1/desk/sales
البيع السريع من المكتب
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/desk/days/{date}
مبيعات يوم، أو تسويته بصيغة CSV أو PDF
النطاق: statements:read
POST/api/b2b/v1/desk/days/{date}/close
إقفال اليوم وتثبيت تسويته
النطاق: statements:readيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

نقل الشركات

GET/api/b2b/v1/corporate/cost-centres
القائمة
النطاق: bookings:view
POST/api/b2b/v1/corporate/cost-centres
الإنشاء أو التعديل
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/cost-centres/{id}/approvers
الإنشاء أو التعديل
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/corporate/requests
القائمة
النطاق: bookings:view
POST/api/b2b/v1/corporate/requests
الحجز
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/requests/{id}/decision
الموافقة أو الرفض
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/corporate/shuttles
القائمة
النطاق: bookings:view
POST/api/b2b/v1/corporate/shuttles
الإنشاء أو التعديل
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/shuttles/{id}/status
تغيير الحالة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/shuttles/{id}/schedule
جدولة رحلات شهر
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/corporate/shuttles/{id}/reprice
اعتماد سعر اتُّفق عليه حديثاً
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/corporate/usage
الاستخدام حسب مركز التكلفة (JSON أو CSV)
النطاق: statements:read

برامج DMC

GET/api/b2b/v1/dmc/programmes
القائمة
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes
الإنشاء أو التعديل
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/dmc/programmes/{id}
التفاصيل
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes/{id}/versions
حفظ نسخة مسعّرة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/dmc/programmes/{id}/status
تغيير الحالة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/dmc/programmes/{id}/brand
علامتك التجارية، أو بلا علامة، على مستنداته
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/dmc/programmes/{id}/accept
قبول نسخة وحجزها
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/dmc/programmes/{id}/proposal
عرض للعميل (HTML)
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes/{id}/links
إصدار رابط للعميل محدد المدة
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
GET/api/b2b/v1/dmc/programmes/{id}/links
روابط العملاء ومن قبِلها
النطاق: bookings:view
POST/api/b2b/v1/dmc/programmes/{id}/links/{link}/revoke
إلغاء رابط عميل
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

الأسعار وطلبات عروض الأسعار

GET/api/b2b/v1/rates/catalogue
الكتالوج بأسعارك (JSON أو CSV أو PDF)
النطاق: rates:view
GET/api/b2b/v1/rates/sheet
جدول أسعار الخدمات
النطاق: rates:view
POST/api/b2b/v1/quote-requests
إرسال طلب عرض سعر
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/wholesale-requests
طلب سعة من المركبات
النطاق: bookings:createيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

أداة الحجز

GET/api/b2b/v1/widget
إعدادات الأداة ومقتطفها البرمجي
النطاق: tracking:view
POST/api/b2b/v1/widget
تعديل الأداة
النطاق: tracking:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

المستخدمون

GET/api/b2b/v1/users
القائمة
النطاق: users:view
POST/api/b2b/v1/users
دعوة شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/users/{id}/role
تغيير دور شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/users/{id}/deactivate
إيقاف وصول شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/users/{id}/reactivate
استعادة وصول شخص
النطاق: users:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

الإشعارات

GET/api/b2b/v1/inbox
إشعارات تخص حسابك
النطاق: inbox:view

كشوف الحساب والفواتير

GET/api/b2b/v1/statements
كشوف الحساب والرصيد والفواتير المفتوحة
النطاق: statements:read
GET/api/b2b/v1/statements/{period}
كشف حساب شهر واحد (JSON أو PDF)
النطاق: statements:read
GET/api/b2b/v1/invoices/{id}
فاتورة واحدة (JSON أو PDF)
النطاق: statements:read

إعدادات الحساب

GET/api/b2b/v1/settings
بيانات الحساب وجهات الاتصال وبريد الفواتير
النطاق: settings:view
POST/api/b2b/v1/settings/billing-email
تحديد بريد الفواتير
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/settings/contacts
إضافة جهة اتصال أو تعديلها
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/settings/contacts/{id}/remove
حذف جهة اتصال
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة
POST/api/b2b/v1/settings/brand
علامتك التجارية، أو بلا علامة، على مستنداته
النطاق: settings:manageيتطلب مفتاحاً فعلياً — يُصدر عند الموافقة

POST /api/b2b/v1/transport/quote

curl -X POST 'https://nwp.ae/api/b2b/v1/transport/quote' \
  -H 'Authorization: Bearer nwp_test_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7f1c2b0e-quote-1' \
  -d '{"airport":"dxb","terminal":"t3","direction":"from_airport","place":"downtown","vehicle":"vclass","pickup_date":"2026-11-02","pickup_time":"14:30","passengers":3,"bags":3}'

المصادقة

1طلب رمز لبيئة الاختبار

POST /api/b2b/orchestration

curl -X POST https://nwp.ae/api/b2b/orchestration \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "developer_handshake",
    "platform_name": "Example Travel App",
    "contact_email": "developers@example.com",
    "use_case": "transfers"
  }'

201 Created

{
  "environment": "sandbox",
  "status": "early-access",
  "test_data": true,
  "token_type": "Bearer",
  "token": "nwp_sandbox_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImVudiI6InNhbmRib3gifQ…",
  "expires_at": "2026-10-31T08:00:00.000Z",
  "scopes": [
    "sandbox:transfers.quote",
    "sandbox:availability.read"
  ],
  "endpoints": [
    {
      "method": "POST",
      "url": "https://nwp.ae/api/b2b/sandbox/transfers"
    },
    {
      "method": "GET",
      "url": "https://nwp.ae/api/b2b/sandbox/availability"
    },
    {
      "method": "GET",
      "url": "https://nwp.ae/api/b2b/sandbox/status"
    }
  ],
  "production": {
    "status": "not_open",
    "request_access": "https://nwp.ae/register?type=institutional"
  }
}

2استدعاء بيئة الاختبار باستخدامه

POST /api/b2b/sandbox/transfers

curl -X POST https://nwp.ae/api/b2b/sandbox/transfers \
  -H 'Authorization: Bearer nwp_sandbox_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImVudiI6InNhbmRib3gifQ…' \
  -H 'Content-Type: application/json' \
  -d @transfer.json

طلب النقل

pickup_locationإلزامي: { type: "airport" | "coordinates" | "hotel", … }
مكان استقبال الراكب: مبنى ركاب في المطار (DXB_T1, DXB_T2, DXB_T3, DWC, SHJ)، أو إحداثيات داخل الإمارات، أو مرجع فندق.
dropoff_locationإلزامي: { type: "hotel" | "coordinates" | "airport", … }
المكان الذي يُنقل إليه الراكب: نص مرجعي للفندق (رمز الفندق لديكم أو اسم الفندق)، أو إحداثيات، أو مبنى ركاب في المطار.
flight_numberمشروط: string
الرحلة القادمة، مثل EK202. يُضبط موعد الاستقبال على موعد الهبوط المجدول للرحلة.
pickup_atمشروط: string (ISO 8601)
بصيغة ISO 8601 مع فارق التوقيت. إلزامي عندما لا يكون الاستقبال من مطار، أو عندما لا يكون لاستقبال المطار رقم رحلة.
buffer_minutes_overrideاختياري: integer
الانتظار المجاني بعد الهبوط، بالدقائق، من 0 إلى 180. القيمة الافتراضية 60: وهي مدة الانتظار المجاني التي يمنحها موقع النقل التابع للمجموعة لكل وصول.
vehicle_classإلزامي: enum
إحدى القيم: VIP_V_CLASS أو EXECUTIVE_SEDAN أو LUXURY_COACH.
passengersاختياري: integer
يُرفض إذا تجاوز عدد مقاعد الفئة.
client_metadataاختياري: object
تفاصيل العلامة البيضاء لقسيمة المسافر: agency_name و logo_url (عبر https فقط) و voucher_branding و agency_reference.

الحقل	النوع	إلزامي	الوصف
`pickup_location`	`{ type: "airport" \| "coordinates" \| "hotel", … }`	إلزامي	مكان استقبال الراكب: مبنى ركاب في المطار (DXB_T1, DXB_T2, DXB_T3, DWC, SHJ)، أو إحداثيات داخل الإمارات، أو مرجع فندق.
`dropoff_location`	`{ type: "hotel" \| "coordinates" \| "airport", … }`	إلزامي	المكان الذي يُنقل إليه الراكب: نص مرجعي للفندق (رمز الفندق لديكم أو اسم الفندق)، أو إحداثيات، أو مبنى ركاب في المطار.
`flight_number`	`string`	مشروط	الرحلة القادمة، مثل EK202. يُضبط موعد الاستقبال على موعد الهبوط المجدول للرحلة.
`pickup_at`	`string (ISO 8601)`	مشروط	بصيغة ISO 8601 مع فارق التوقيت. إلزامي عندما لا يكون الاستقبال من مطار، أو عندما لا يكون لاستقبال المطار رقم رحلة.
`buffer_minutes_override`	`integer`	اختياري	الانتظار المجاني بعد الهبوط، بالدقائق، من 0 إلى 180. القيمة الافتراضية 60: وهي مدة الانتظار المجاني التي يمنحها موقع النقل التابع للمجموعة لكل وصول.
`vehicle_class`	`enum`	إلزامي	إحدى القيم: VIP_V_CLASS أو EXECUTIVE_SEDAN أو LUXURY_COACH.
`passengers`	`integer`	اختياري	يُرفض إذا تجاوز عدد مقاعد الفئة.
`client_metadata`	`object`	اختياري	تفاصيل العلامة البيضاء لقسيمة المسافر: agency_name و logo_url (عبر https فقط) و voucher_branding و agency_reference.

transfer.json

{
  "pickup_location": {
    "type": "airport",
    "terminal": "DXB_T3"
  },
  "dropoff_location": {
    "type": "hotel",
    "hotel_ref": "EXAMPLE-HOTEL-DOWNTOWN"
  },
  "flight_number": "EK202",
  "buffer_minutes_override": 60,
  "vehicle_class": "VIP_V_CLASS",
  "passengers": 4,
  "client_metadata": {
    "agency_name": "Example Travel",
    "logo_url": "https://example.com/logo.png",
    "voucher_branding": {
      "mode": "white_label",
      "accent_hex": "#0A0A0A"
    },
    "agency_reference": "EX-10442"
  }
}

فئات المركبات

الفئة	المركبة	المقاعد
`VIP_V_CLASS`	Mercedes-Benz V-Class or similar	7
`EXECUTIVE_SEDAN`	Lexus ES 350 or a similar executive saloon	3
`LUXURY_COACH`	Toyota Coaster or King Long coach	30

تُستأجر كل مركبة مع سائقها المرخّص للمهمة؛ وتحدد الفئة نوع المركبة وعدد مقاعدها.

الرد

200 OK

{
  "environment": "sandbox",
  "test_data": true,
  "notice": "Sandbox response: test data only. Nothing is booked, no vehicle is held and no price is quoted. Production is not open yet.",
  "quote_id": "SBX-WT5PCXWF",
  "status": "sandbox_accepted",
  "vehicle": {
    "class": "VIP_V_CLASS",
    "description": "Mercedes-Benz V-Class or similar",
    "max_passengers": 7
  },
  "passengers": 4,
  "pickup": {
    "location": {
      "type": "airport",
      "terminal": "DXB_T3"
    },
    "timing": {
      "mode": "flight_landing",
      "flight_number": "EK202",
      "driver_ready": "at the scheduled landing time",
      "free_waiting_minutes": 60,
      "live_arrival_tracking": "planned"
    }
  },
  "dropoff": {
    "location": {
      "type": "hotel",
      "hotel_ref": "EXAMPLE-HOTEL-DOWNTOWN"
    }
  },
  "voucher": {
    "branding": "white_label",
    "agency_name": "Example Travel",
    "logo_url": "https://example.com/logo.png",
    "accent_hex": "#0A0A0A",
    "footer_text": null,
    "agency_reference": "EX-10442",
    "shows_nwp_branding": false
  },
  "price": null,
  "price_note": "Sandbox quotes carry no price. Net rates are issued to approved partners in the portal.",
  "default_buffer_minutes": 60,
  "created_at": "2026-10-01T08:00:00.000Z"
}

422 Unprocessable Entity

{
  "error": {
    "code": "validation_failed",
    "message": "One or more fields are invalid.",
    "retryable": false,
    "fields": [
      "flight_number"
    ],
    "issues": [
      {
        "path": "flight_number",
        "message": "flight_number must be an airline flight number such as EK202."
      }
    ]
  },
  "environment": "sandbox"
}

توقيت الرحلات

التوفر الموقَّع

GET /api/b2b/sandbox/availability

curl 'https://nwp.ae/api/b2b/sandbox/availability?date=2026-10-15&vehicle_class=VIP_V_CLASS&expires=1760572800&sig=…'

200 OK

{
  "environment": "sandbox",
  "test_data": true,
  "notice": "Sandbox response: test data only. Nothing is booked, no vehicle is held and no price is quoted. Production is not open yet.",
  "date": "2026-10-15",
  "vehicle_class": "VIP_V_CLASS",
  "vehicle": {
    "description": "Mercedes-Benz V-Class or similar",
    "max_passengers": 7
  },
  "sample_status": "on_request",
  "note": "A sample status for building against. Real availability is confirmed by the trade desk until the API opens."
}

إجراءات الحساب

الإجراء	ما يفعله
`credit_line_application`	شروط Net-15 أو 30 أو 45 أو 60 لشركة مسجّلة في الإمارات. رقم الرخصة التجارية ورقم TRN (15 رقماً، يبدأ بـ 100) مطلوبان. يراجع موظف كل طلب، وتكون الحجوزات مدفوعة مسبقاً إلى أن يُعتمد خط ائتمان.
`wallet_topup`	دفعة مسبقة إلى حسابكم. الشحن بالبطاقة غير متاح بعد، لذا يرسل إليكم مكتب الوكالات فاتورة للدفع بتحويل بنكي، ويشير الرد إلى ذلك.
`account_payload`	مصفوفة العملات لحسابكم. AED هي العملة الأساسية والعملة الوحيدة التي يُحتسب بها أي مبلغ مدفوع أو مكتسب؛ والعملات الأخرى تحويلات للعرض بالسعر اليومي للموقع، فلا يتغيّر الهامش أبداً بالتحويل.
`tracking_link`	رابط شريك حتمي ورمز QR لمستويي بيوت العطلات والمسوّقين بالعمولة، مع بيان واضح بالجهة التي يُنسب إليها حالياً.
`developer_handshake`	رمز لبيئة الاختبار، ونقاط نهاية بيئة الاختبار، وعنوان URL موقَّع للتوفر.

action: credit_line_application

{
  "action": "credit_line_application",
  "company_legal_name": "Example Travel L.L.C.",
  "trade_licence_number": "1234567",
  "licence_authority": "Department of Economy and Tourism, Dubai",
  "trn": "100000000000003",
  "contact_name": "Finance Desk",
  "contact_email": "finance@example.com",
  "requested_terms": "NET_30",
  "requested_limit_aed": 50000
}

action: wallet_topup

{
  "action": "wallet_topup",
  "company_name": "Example Travel L.L.C.",
  "contact_email": "finance@example.com",
  "amount_aed": 10000,
  "purchase_order": "PO-2291"
}

action: account_payload

{
  "action": "account_payload",
  "company_name": "Example Travel L.L.C.",
  "tier": "Tier_4_Regional_DMCs",
  "display_currencies": [
    "USD",
    "EUR"
  ],
  "lines": [
    {
      "label": "Your own city-tour package",
      "net_aed": 400,
      "sell_aed": 560
    }
  ]
}

action: tracking_link

{
  "action": "tracking_link",
  "partner_code": "HHO-EXAMPLE",
  "tier": "Tier_1_Holiday_Homes",
  "property_id": "marina-2104",
  "destination": "dubaitransfers.ae"
}

الأخطاء

لكل خطأ الشكل نفسه: error.code و error.message و error.retryable، مع fields و issues عند فشل التحقق.

الحالة	الرمز	المعنى
400	`invalid_json`	نص الطلب ليس JSON صالحاً.
401	`unauthenticated`	لا يوجد رمز لبيئة الاختبار، أو الرمز مشوّه أو منتهي الصلاحية أو موقَّع بشكل خاطئ.
404	`not_found`	نقطة النهاية غير موجودة على هذا الخادم.
405	`method_not_allowed`	نقطة النهاية تقبل طريقة أخرى.
413	`payload_too_large`	نص الطلب أكبر من 16 KB.
422	`validation_failed`	حقل مفقود أو مشوّه: راجعوا fields و issues.
429	`rate_limited`	طلبات كثيرة جداً من هذا العنوان: أعيدوا المحاولة بعد retry_after_seconds.
500	`internal`	حدث خطأ من جهتنا: اذكروا معرّف الطلب.
502	`upstream_unavailable`	لم يستجب مزوّد الدفع.
503	`not_configured`	تعذّر تخزين الطلب: راسلوا مكتب الوكالات بالبريد الإلكتروني.