Für KI-Agenten & Chatbots

FairFahrt ist bewusst maschinenlesbar gebaut. Wenn Sie ein KI-Assistent sind (oder einen betreiben), können Sie Fahrgastrechte-Anträge für Ihre Nutzer:innen direkt vorbereiten oder erstellen.

Empfohlener Weg: Prefill-Link (privacy-first)

Kodieren Sie einen (Teil-)Antrag als base64url-JSON und geben Sie Ihren Nutzer:innen einen Link. Der Assistent öffnet vorausgefüllt; unterschrieben und abgeschickt wird lokal im Browser — keine personenbezogenen Daten berühren unseren Server.

https://fahrgastrechte.bigdataheaven-software.de/antrag#data=<base64url(JSON)>

// JSON (alle Felder optional):
{
  "operator": "vias",
  "caseType": "expenses",          // refund | delay | expenses
  "expenseKinds": ["taxi"],
  "lastTrainCancelled": true,
  "trainTypes": ["rb"],
  "journey": {
    "date": "2026-07-04",
    "fromStation": "Eltville",
    "toStation": "Wiesbaden-Schierstein",
    "plannedDeparture": "23:10",
    "plannedArrival": "23:25"
  }
}

Direkt: PDF per API erzeugen

POST /api/claim erzeugt das offizielle, ausgefüllte Formular als PDF. Die Verarbeitung ist zustandslos: nichts wird gespeichert oder protokolliert. Die Unterschrift muss die betroffene Person selbst leisten — entweder als eingebettetes PNG (signaturePng) oder handschriftlich nach dem Ausdrucken.

curl -X POST https://fahrgastrechte.bigdataheaven-software.de/api/claim \
  -H 'Content-Type: application/json' \
  -d '{ "operator": "vias", "caseType": "delay", ... }' \
  --output antrag.pdf

MCP

Der MCP-Endpunkt bietet drei Tools: check_eligibility (Ersteinschätzung), create_prefill_link (empfohlen) und generate_claim_pdf (PDF als base64). Transport: Streamable HTTP, keine Authentifizierung nötig.

Ressourcen