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