Ö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-2026

Demo-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.

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
}

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.

GET /api/v1/editorial/AF/light

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.

GET /api/v1/editorial

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

CodeHTTPBedeutung
UNAUTHORIZED401Fehlender oder ungültiger API-Schlüssel
FORBIDDEN403Schlüssel widerrufen
NOT_FOUND404Redaktionelles Datenblatt nicht gefunden
RATE_LIMITED429Tä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.

FareTag-API für Entwickler — Dokumentation