Die Fahrplan und Suchmaschinen-API ermöglicht dir das sichere und kontrollierte Abrufen von Suchergebnissen für externe Systeme, Suchportale und Verzeichnisse.
## Voraussetzungen
Um die Fahrten abfragen zu können, benötigst du:
- Ein Token vom Accountinhaber
- Die entsprechende URL
## Verfügbare Parameter
Folgende Parameter kannst du per GET an die URL anhängen:
- xml_token: Der Token, den du für den Zugriff erhältst
- datum: Das Datum im Unix Timestamp Format ab wann die Ergebnisse abgerufen werden sollen
- bis_datum: Das Datum im Unix Timestamp Format bis wann die Ergebnisse dargestellt werden sollen (maximal 1 Monat)
- max_days: Anzahl der angezeigten Tage (maximal 31 Tage)
- linie_region_id: Optional, zur Einschränkung auf eine bestimmte Linienregion
- linie_typ_id: Optional, zur Einschränkung auf einen bestimmten Linientyp
- linie_id: Optional, gibt nur diese Linie aus
- station_id: Optional, zeigt nur Ergebnisse von dieser Abfahrtstation
- zielstation_id: Optional, zeigt nur Ergebnisse zu dieser Zielstation
- ressource_id: Optional, zeigt nur Ergebnisse mit der angegebenen Ressource
- personen_id: Optional, zur Identifikation der Person
- kapazitaet: Optional, zur Ausgabe der Fahrkapazität (Performance kostet)
## Suchergebnis
Das Suchergebnis wird als JSON ausgegeben und in folgende Abschnitte gruppiert:
- Meta Informationen (meta): Datum der Erzeugung
- Mandant-Informationen (shops): Informationen zum Mandanten und der Ziel-URL
- Stationen (stations): Verfügbare Stationen
- Verbindungen (relations): Fahrtkombinationen mit Preistyp und Betreiber der Linie
## Einbindung Buchungsmaske
Die URL der Buchungsmaske wird im Suchergebnis im Abschnitt "shop" ausgegeben. Um die Buchungsmaske direkt mit dem gewählten Suchergebnis zu laden, kannst du folgende optionale Parameter verwenden:
- hafen_id: Abfahrtstation als Int-Wert
- zielhafen_id: Zielstation als Int-Wert
- linie_id: Einschränkung auf eine bestimmte Linie
- hinfahrt_datum: Datum der Hinfahrt als Unix-Timestamp
- anzeige_tage: Anzahl der Vorschau des Suchergebnisses in Tagen
- einfache_fahrt: true als String für nur Hinfahrt
- rueckfahrt_datum: Datum der Rückfahrt als Unix-Timestamp (optional)
- vermittler_id: Provisionsempfänger-ID des anbindenden Portals
## Beispiel Buchungsmaske