API عامة V1
ادمج محرك FareTag
محرك الحكم والقاعدة التحريرية، متاحان عبر API. قيِّم بيانات تعريفتك الخاصة أو استعلم عن قاعدة الشروط الموثَّقة لدينا.
المصادقة
كل طلب يستلزم رأس X-Api-Key. مفتاح تجريبي متاح للاختبار:
X-Api-Key: faretag-demo-key-2026المفتاح التجريبي: 25 طلبًا/يوم. للاستخدام في الإنتاج، تواصل معنا أدناه.
حدود البيانات
لا تُكشَف بيانات الحجز التابعة لجهات خارجية (الأسعار، التوفر، العروض) عبر API. المحرك يُقيِّم بياناتك، والقاعدة التحريرية ملكنا.
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 لشركة طيران وعائلة تعريفية، مع الحكم المحسوب والمصدر المؤرَّخ.
404 إذا لم تكن شركة الطيران أو العائلة مشمولة.
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 | المعنى |
|---|---|---|
| UNAUTHORIZED | 401 | مفتاح API مفقود أو غير صالح |
| FORBIDDEN | 403 | المفتاح ملغى |
| NOT_FOUND | 404 | البيانات التحريرية غير موجودة |
| RATE_LIMITED | 429 | تم تجاوز الحصة اليومية |
بيئة الاختبار
اختبر المحرك بالمفتاح التجريبي. اختر الشروط وشغِّل التقييم.
الترخيص
ابتداءً من 150 EUR/شهر. حصة مخصصة، دعم تقني، SLA. تواصل معنا لمناقشة حالة استخدامك.