بحث متعدد الوسائط
استعلم في طلب واحد عن جميع مشغلي القطار والحافلة الذين يخدمون رحلة معينة: الأسعار، المدد، التوقفات، الفئات، بطاقات التخفيض وانبعاثات CO₂ تُعاد في الوقت الفعلي.
API الشركاء
API القطار والحافلة الأوروبية لشركائك
API REST واحدة للبحث والحجز والإلغاء والوصول إلى الحجوزات المسبقة لجميع شركات القطار والحافلة التي نوزعها. Sandbox مجاني، توثيق OpenAPI، دعم شركاء مخصص.
الميزات
مسار التذكرة الكامل، معروض عبر API
تغطي API شركاء Gopaxo الخطوات الأربع الحرجة في دورة حياة تذكرة القطار أو الحافلة، لتجنبك دمج كل شركة على حدة.
الحجز والإصدار
احجز وأصدر التذاكر مباشرة من API: مسافرون اسميون، مقاعد محددة، خيارات أمتعة، بطاقات تخفيض، دفع آمن عبر PSP الخاص بك أو الخاص بنا.
الإلغاء والاسترداد
ألغِ تذكرة في عدة استدعاءات، وفعّل الاسترداد وفقًا لشروط المشغل. حالات تفصيلية، أسباب فشل موحدة، سجل أحداث قابل للتتبع.
حجوزات مسبقة
ادخل إلى افتتاحات البيع والحجوزات المسبقة للمشغلين (TGV، Eurostar، Trenitalia، FlixBus…) بمجرد توفرها. Webhooks لإشعار مستخدميك في الوقت الفعلي.
تغطية شركات النقل
جميع شركات القطار والحافلة التي نوزعها
تكشف API Gopaxo المخزون الكامل الذي نشغّله على الجانب العام: كبرى شركات السكك الحديدية، شركات الميزانية المنخفضة وشركات الحافلات للمسافات الطويلة، في 160 دولة.
شركات القطار
جميع كبار مشغلي السكك الحديدية ومعظم المشغلين الإقليميين الأوروبيين متاحون من نقطة نهاية واحدة.
- SNCF
- OUIGO
- Eurostar
- Thalys
- Trenitalia
- Italo
- Renfe
- Deutsche Bahn
- ÖBB
- SBB
- NS
- SNCB
- CFL
- PKP
- ČD
- MÁV
- CP
- DSB
- VR
- + شركات إقليمية
شركات الحافلات والباصات
كبرى شركات الحافلات الأوروبية للمسافات الطويلة متاحة عبر نفس API المستخدمة للقطارات.
- FlixBus
- BlaBlaCar Bus
- Alsa
- Megabus
- National Express
- Eurolines
- RegioJet
- Student Agency
- Marino Bus
- Itabus
- Westbahn
- Vy Buss
- Onnibus
- + شركات إقليمية
المواصفات التقنية
مصممة لفرق المنتج والمنصة
API REST حديثة وموثقة وقابلة للملاحظة، جاهزة لمراجعة فرق الأمن والمعمارية لديك.
REST + JSON، OpenAPI 3
نقاط نهاية REST موثقة بـ OpenAPI 3، مخططات مكتوبة، أمثلة payloads لكل مسار. متوافقة مع جميع مولدات SDK في السوق.
OAuth 2 ومفاتيح API
مصادقة OAuth 2 client credentials أو مفاتيح API دوارة حسب منظومتك التقنية. نطاقات (scopes) دقيقة لكل مسار (search, book, cancel) ولكل بيئة.
Webhooks للأحداث
إشعارات موقعة (HMAC) للأحداث الرئيسية: تأكيد الحجز، تغيير الجدول، إلغاء من المشغل، استرداد صادر. إعادة محاولات تلقائية.
Sandbox مجاني
بيئة اختبار مطابقة وظيفيًا للإنتاج، ببيانات اختبار مستقرة. لا حد للاستدعاءات، لا التزامات، وصول مشترك لكل فريقك.
SLA 99.9٪ وقابلية الملاحظة
توفر تعاقدي 99.9٪، statuspage مشتركة، p50 < 800 ميلي ثانية على البحث. سجلات وآثار قابلة للدفع إلى منظومتك (Datadog، Grafana، Sentry…).
التوثيق وSDKs
بوابة مطورين كاملة، أمثلة curl وPostman، أدلة تكامل لكل حالة استخدام. SDKs رسمية بـ TypeScript وPython، مجتمع مفتوح المصدر على GitHub.
التهيئة
أربع خطوات للانتقال من sandbox إلى الإنتاج
صُممت عملية التهيئة لدينا لتقديم POC وظيفي بسرعة، دون التضحية بجودة الانتقال إلى الإنتاج.
1. ترسل النموذج
صف حالة استخدامك، منظومتك التقنية، حجمك المستهدف وجدولك الزمني المثالي. 3 دقائق تكفي.
2. الرد خلال 24 ساعة عمل
يتواصل معك أحد أعضاء فريق الشركاء لتأهيل الحاجة وجدولة جلسة تحديد نطاق تقني مدتها 30 دقيقة.
3. الوصول إلى Sandbox
رمز sandbox وتوثيق وأمثلة تُرسل مباشرة بعد ذلك. يمكنك البدء في البرمجة فورًا، دون أي التزام.
4. التعاقد والانتقال إلى الإنتاج
بمجرد التحقق من POC، نتعاقد (عمولة أو اشتراك) ثم ننتقل إلى الإنتاج بنشر تدريجي ومتابعة مشتركة.
أسئلة API
الأسئلة التقنية الأكثر تكرارًا
الأسئلة التي نراجعها مع شركائنا أثناء تحديد النطاق التقني واختبار sandbox.
هل تسمح API فعلًا بالحجز وإصدار التذاكر؟
نعم. تدير API المسار الكامل: البحث، اختيار العرض، إنشاء المسافرين الاسميين، الدفع، إصدار التذكرة (PDF، باركود، Apple Wallet / Google Wallet حسب المشغل) وإرسال الإثباتات.
كيف يعمل الإلغاء والاسترداد؟
يمكن إلغاء كل تذكرة صادرة عبر نقطة نهاية مخصصة. تُعيد API قواعد الإلغاء (المهلة، المبلغ القابل للاسترداد، الرسوم) قبل التأكيد. يُفعّل الاسترداد تلقائيًا وفقًا لشروط المشغل ووسيلة الدفع الأصلية.
هل لديكم وصول إلى الحجوزات المسبقة للمشغلين؟
نعم. يدمج محركنا تقاويم افتتاح البيع للمشغلين الرئيسيين (TGV، Eurostar، Trenitalia، Renfe، FlixBus). يمكنك استعلام API مسبقًا واستقبال webhook بمجرد توفر التذاكر.
ما التنسيق؟ REST، GraphQL، gRPC؟
REST + JSON، مع مواصفات OpenAPI 3 متاحة للتنزيل. هذا هو التنسيق الأكثر دعمًا من أدوات التكامل مع الشركاء (Postman، توليد SDKs، بوابات API). GraphQL غير معروض للعموم.
ما نوع المصادقة؟
OAuth 2 client credentials بشكل افتراضي للتكاملات server-to-server، مع تدوير الأسرار من جانب الشريك. تبقى مفاتيح API طويلة الأمد ممكنة لحالات محددة (CI، edge functions). جميع الطلبات يجب أن تستخدم TLS 1.2+.
هل يوجد sandbox؟ وهل هو مجاني؟
نعم، sandbox مجاني 100٪ ودون التزام. يكشف نفس نقاط النهاية الموجودة في الإنتاج، على مجموعة بيانات اختبار مستقرة. يمكنك إبقاؤه مفتوحًا طالما كنت بحاجة إليه للتكامل والاختبار والترويج داخليًا.
ما مهل الوصول؟
خلال 24 ساعة عمل للرد الأول من فريق الشركاء. يُسلَّم رمز sandbox عادةً خلال 48 ساعة عمل بعد تحديد النطاق التقني.
كيف تتم فوترتنا في الإنتاج؟
ثلاثة نماذج متاحة: عمولة على المبيعات (الأكثر شيوعًا)، اشتراك في المنصة + عمولة مخفضة، أو ترخيص مخصص للأحجام الكبيرة جدًا. لا فوترة طالما بقيت في sandbox.
هل أنتم متوافقون مع GDPR وPCI-DSS؟
نعم. تُستضاف البيانات الشخصية في الاتحاد الأوروبي وتُعالج بموجب عقد معالجة بيانات وفقًا لـ GDPR. يمر تدفق الدفع عبر PSP معتمد PCI-DSS من المستوى 1؛ لا تخزّن Gopaxo أبدًا بيانات البطاقة بصيغة واضحة.