API عامة V1

ادمج محرك FareTag

محرك الحكم والقاعدة التحريرية، متاحان عبر API. قيِّم بيانات تعريفتك الخاصة أو استعلم عن قاعدة الشروط الموثَّقة لدينا.

المصادقة

كل طلب يستلزم رأس X-Api-Key. مفتاح تجريبي متاح للاختبار:

X-Api-Key: faretag-demo-key-2026

المفتاح التجريبي: 25 طلبًا/يوم. للاستخدام في الإنتاج، تواصل معنا أدناه.

حدود البيانات

لا تُكشَف بيانات الحجز التابعة لجهات خارجية (الأسعار، التوفر، العروض) عبر API. المحرك يُقيِّم بياناتك، والقاعدة التحريرية ملكنا.

POST /api/v1/verdict

أرسل شروطًا تعريفية منظَّمة، استقبل حكمًا كاملًا. لا شبكة خارجية، لا تبعيات لجهات ثالثة.

POST /api/v1/verdict
{
  "refund": { "status": "allowed_with_fee", "fee": { "amount": 50, "currency": "EUR" } },
  "change": { "status": "not_allowed" },
  "baggage": { "checked_included": 1, "status": "known" },
  "fare_total": 400
}

الاستجابة:

{
  "grade": "C",
  "score": 53,
  "capApplied": null,
  "unknownCount": 0,
  "axes": [
    { "id": "refund", "label": "refundPenalty", "points": 31, "maxPoints": 40 },
    { "id": "change", "label": "changeNone", "points": 0, "maxPoints": 30 },
    { "id": "baggage", "label": "baggageIncluded", "points": 15, "maxPoints": 15 },
    { "id": "data", "label": "dataComplete", "points": 15, "maxPoints": 15 }
  ],
  "engineVersion": "v2"
}

GET /api/v1/editorial/{iata}/{fareBrand}

يُعيد البيانات التحريرية لـ FareTag لشركة طيران وعائلة تعريفية، مع الحكم المحسوب والمصدر المؤرَّخ.

GET /api/v1/editorial/AF/light

404 إذا لم تكن شركة الطيران أو العائلة مشمولة.

GET /api/v1/editorial

قائمة التغطية: جميع شركات الطيران والعائلات الموثَّقة، مع تاريخ آخر تحقق.

GET /api/v1/editorial

شارة قابلة للتضمين

اعرض تقييم FareTag أينما تُباع التذاكر. شارة SVG مولَّدة من الخادم، مخزَّنة مؤقتًا، مرتبطة ببيانات شركة الطيران.

<a href="https://faretag.com/compagnies/AF/light">
  <img src="https://faretag.com/api/badge/AF/light.svg"
       alt="Conditions verified by FareTag" />
</a>

رموز الخطأ

الرمزHTTPالمعنى
UNAUTHORIZED401مفتاح API مفقود أو غير صالح
FORBIDDEN403المفتاح ملغى
NOT_FOUND404البيانات التحريرية غير موجودة
RATE_LIMITED429تم تجاوز الحصة اليومية

بيئة الاختبار

اختبر المحرك بالمفتاح التجريبي. اختر الشروط وشغِّل التقييم.

الترخيص

ابتداءً من 150 EUR/شهر. حصة مخصصة، دعم تقني، SLA. تواصل معنا لمناقشة حالة استخدامك.

FareTag API للمطورين — التوثيق