ПУБЛИЧНЫЙ 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. Свяжитесь с нами, чтобы обсудить ваш случай использования.

API FareTag для разработчиков — Документация