Liste aller Notwendigen Daten für die Bestellung
Alle folgenden Attribute sind Pflichtangaben. Ausnahmen sind mit "optional" gekennzeichnet.
| Attribut | Beispiel / Format | Erklärung |
| semester | 23S / 23W | Semester Sommersemester 23S bzw. Wintersemester 23W |
| matriculationNumber | 123456 | Matrikelnummer |
| salutation | m / f | Anrede m=männlich, f=weiblich "Divers" ist im OTS nicht möglich. Es muss m oder f gewählt werden. |
| title | Dr. | Titel (optional) |
| firstName | Max Moritz | Vorname(n) |
| lastName | Mustermann | Nachname(n) |
| birthdate | 1990-09-07 | Geburtsdatum |
| company | z.B. Studierendensekreteriat | Firma, kann bei allen identisch sein (optional) |
| street | Schlossplatz | Straße |
| streetNumber | 2 | Hausnummer |
| postalCode | 12345 | Postleitzahl |
| city | Musterstadt | Ort |
| country | DE | Land |
| phone | 0123456789 | Telefon (optional) |
| max.mustermann@meine-uni.de | E-Mail Adresse | |
| payment | free | Zahlungsweise (entsprechend www.ots-nrw.de Schritt 3) |
| elv | true | Lastschrift akzeptiert? |
| privacyHs | true | Datenaustausch mit Hochschule akzeptiert? |
| agb | true | AGB akzeptiert? |
| privacy | true | Datenschutzhinweise akzeptiert? |
Weitere Erläuterungen
Für die Bestellung der Tickets ist die Zustimmung / Kenntnisnahme für die Lastschrift, AGB und Datenschutzhinweise notwendig. Die Bestellung kann nur ausgeführt werden, wenn alle 4 Attribute den Wert "true" enthalten.
Unsere Empfehlung:
Lassen Sie die Nutzer in der Anwendung den folgenden Bedingungen und Informationen zustimmen. Im OTS werden folgende Texte im Bestellschritt 5 angezeigt und sind jeweils mit einer Checkbox versehen.
elv: Hiermit bestätige ich, dass der Gesamtbetrag von meinem Konto / meiner Kreditkarte abgebucht werden soll. Bei Semesterticket NRW erfolgt keine Belastung.
privacyHs: Ja, die angegebene Hochschule darf der DB Vertrieb GmbH mitteilen, ob ich unter den hier gemachten Angaben für das fragliche Semester eingeschrieben bin oder nicht.
agb + privacy: Ich akzeptiere die allgemeinen Geschäftsbedingungen und nehme die Datenschutzhinweise zur Kenntnis.
Hinweis
Eine rechtliche Einschätzung, ob diese Checkboxes in Ihrer Anwendung enthalten sein müssen, kann Brain Appeal nicht vornehmen. Bitte lassen Sie sich im Zweifel rechtlich beraten.
Beispiel Request mit curl
Alle Angaben werden über diesen Aufruf an den Ticketgenerator übermittelt. Der Datentransfer erfolgt in diesem Beispiel über die Kommandozile mit cURL (Infos zu cURL mit Ubuntu Linux, cURL mit Windows 10). Andere Formen sind ebenfalls möglich und ggf. abhängig vom eingesetzten System.
Lesbare Variante:
| curl
| --header "Accept: application/json"
| --header "Content-Type: application/json"
| --request POST
| --data '{
| "semester":"20212",
| "matriculationNumber":"123456",
| "salutation":"m",
| "title":"",
| "firstName":"Max Moritz",
| "lastName":"Mustermann",
| "birthdate":"1990-09-07",
| "company":"",
| "street":"Schlossplatz",
| "streetNumber":"2",
| "postalCode":"12345",
| "city":"Musterstadt",
| "country":"DE",
| "phone":"0123456789",
| "email":"max.mustermann@meine-uni.de",
| "payment":"free",
| "elv":"true",
| "agb":"true",
| "privacy":"true",
| "privacyHs":"true"
| }'
| https://www.semestertickets.de
Kompakte Variante:
| curl --header "Accept: application/json" --header "Content-Type: application/json" --request POST --data '{"semester":"20212","matriculationNumber":"123456","salutation":"f","title":"","firstName":"Max Moritz","lastName":"Mustermann","birthdate":"1990-09-07","company":"","street":"Schlossplatz","streetNumber":"2","postalCode":"12345","city":"Musterstadt","country":"DE","phone":"0123456789","email":"max.mustermann@meine-uni.de","payment":"free","elv":"true","agb":"true","privacy":"true","privacyHs":"true"}' https://www.semestertickets.de
Rückgabewert:
Ist die Ticketgenerierung erfolgreich, liefert die Schnittstelle eine URL zurück, über die das Ticket als PDF heruntergeladen werden kann.
Die Gültigkeit des Links zum Ticket-PDF legt der OTS fest. Empfehlung: das TIcket aus Performancegründen in lokalen Cachen legen.
Alternative:
Nach der Ticketgenerierung kann das Ticket an die E-Mail Adresse des Bestellers gesendet werden.