Um Sitzplätze temporär zu blocken müssen die freien Plätze ermittelt werden. Der Aufruf wird mit GET durchgeführt.
Parameter |
Bezeichnung |
Bemerkung |
|---|---|---|
| aktion=getSitzplatz | Gibt die Aktion an | Pflichtparameter |
| klasse_id | ID der Buchungsklasse | Pflichtparameter |
| schiff_id | ID der Ressource | Pflichtparameter |
| start_linie_hafen_id | ID der Start-Station in der Linie-Hafen-Tabelle | Pflichtparameter |
| stop_linie_hafen_id | ID der Ziel-Station in der Linie-Hafen-Tabelle | Pflichtparameter. |
| fahrt | Nummer der Fahrt | Pflichtparameter. |
| linie_id | ID der Linie | Pflichtparameter |
| sitzplan_kategorie_id | ID der Sitzplan-Kategorie. Wert ist aus dem Feld „schiff_sitzplan_kategorie_id“ aus dem Fahrplan-Ergebnis | Pflichtparameter |
| token | XML-Token | Wird vom Anbieter bereitgestellt. Pflichtparameter |
| datum_fahrt | Datum der Fahrt als Unix-Timestamp | Pflichtparameter. Achtung: Es muss das Datum aus dem Request-Array verwendet werden, bei mehrtägigen Linien wird das Anfangsdatum der ersten Station verwendet. |
Der Aufruf gibt ein leeres Array zurück wenn nichts gefunden wurde, bei erfolgreichem Aufruf wird ein multidimensionales Array zurückgegeben, in dem im Knoten „belegt“ die belegten Plätze enthalten sind (der Key (Index) ist die Platznummr), und bei plaetze die gesamten verfügbaren Plätze für die Anfrage.
Beispielaufruf:
xml.php?aktion=getSitzplatz&token=xyz&linie_id=3&klasse_id=3&fahrt=2&datum_fahrt=1580857200&start_linie_hafen_id=9&stop_linie_hafen_id=15&sitzplan_kategorie_id=1
