ÖFFENTLICHE API V1
FareTag-Engine integrieren
Das Ergebnis-Engine und die redaktionelle Datenbank, per API zugänglich. Bewerten Sie Ihre eigenen Tarifdaten oder fragen Sie unsere Datenbank mit verifizierten Bedingungen ab.
Authentifizierung
Jede Anfrage erfordert einen X-Api-Key-Header. Ein Demo-Schlüssel ist zum Testen verfügbar:
X-Api-Key: faretag-demo-key-2026Demo-Schlüssel: 25 Anfragen/Tag. Für den produktiven Einsatz kontaktieren Sie uns unten.
Datengrenzen
Die API gibt niemals Buchungsdaten von Drittanbietern preis (Preise, Verfügbarkeiten, Angebote). Das Engine bewertet Ihre Daten, das Redaktionelle gehört uns.
POST /api/v1/verdict
Senden Sie strukturierte Tarifbedingungen und erhalten Sie ein vollständiges Ergebnis. Kein ausgehender Netzwerkverkehr, keine externe Abhängigkeit.
{
"refund": { "status": "allowed_with_fee", "fee": { "amount": 50, "currency": "EUR" } },
"change": { "status": "not_allowed" },
"baggage": { "checked_included": 1, "status": "known" },
"fare_total": 400
}Antwort:
{
"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}
Gibt das redaktionelle FareTag-Datenblatt für eine Fluggesellschaft und eine Tariffamilie zurück, mit berechnetem Ergebnis und datierter Herkunft.
404 wenn die Fluggesellschaft oder die Familie nicht abgedeckt ist.
GET /api/v1/editorial
Abdeckungsliste: alle dokumentierten Fluggesellschaften und Familien, mit Datum der letzten Überprüfung.
Einbettbares Abzeichen
Zeigen Sie die FareTag-Note überall, wo ein Ticket verkauft wird. Server-generiertes SVG-Abzeichen, gecacht, verknüpft mit dem Fluggesellschafts-Datenblatt.
<a href="https://faretag.com/compagnies/AF/light">
<img src="https://faretag.com/api/badge/AF/light.svg"
alt="Conditions verified by FareTag" />
</a>Fehlercodes
| Code | HTTP | Bedeutung |
|---|---|---|
| UNAUTHORIZED | 401 | Fehlender oder ungültiger API-Schlüssel |
| FORBIDDEN | 403 | Schlüssel widerrufen |
| NOT_FOUND | 404 | Redaktionelles Datenblatt nicht gefunden |
| RATE_LIMITED | 429 | Tägliches Kontingent überschritten |
Playground
Testen Sie das Engine mit dem Demo-Schlüssel. Wählen Sie Bedingungen aus und starten Sie das Scoring.
Lizenz
Ab 150 EUR/Monat. Individuelles Kontingent, technischer Support, SLA. Kontaktieren Sie uns, um Ihren Anwendungsfall zu besprechen.