Schnittstellenbeschreibung

Ticketgenerator

Alle folgenden Attribute sind Pflichtangaben. Ausnahmen sind mit "optional" gekennzeichnet.

AttributBeispiel / FormatErklärung
semester23S / 23WSemester
Sommersemester 23S bzw. Wintersemester 23W
matriculationNumber123456Matrikelnummer
salutationm / fAnrede m=männlich, f=weiblich
"Divers" ist im OTS nicht möglich. Es muss m oder f gewählt werden.
titleDr.Titel (optional)
firstNameMax MoritzVorname(n)
lastNameMustermannNachname(n)
birthdate1990-09-07Geburtsdatum
companyz.B. StudierendensekreteriatFirma, kann bei allen identisch sein (optional)
streetSchlossplatzStraße
streetNumber2Hausnummer
postalCode12345Postleitzahl
cityMusterstadtOrt
countryDELand
phone0123456789Telefon (optional)
emailmax.mustermann@meine-uni.deE-Mail Adresse
paymentfreeZahlungsweise (entsprechend www.ots-nrw.de Schritt 3)
elvtrueLastschrift akzeptiert?
privacyHstrueDatenaustausch mit Hochschule akzeptiert?
agbtrueAGB akzeptiert?
privacytrueDatenschutzhinweise 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.

Weitere Produkte

Auch diese Systeme sind nützlich für Ihre Hochschule:

Campus Events

Veranstaltungen und Termine einfach verwalten und organisieren.

Mehr über Campus Events

Campus Lingo

Mehrsprachige TYPO3 Seiten. Automatisch übersetzt. In wenigen Sekunden. In über 30 Sprachen.

Mehr über Campus Lingo

Campus Time

Zeiterfassung nach TV-L / TVöD: Projektbudgets, Prozesse, Langzeitkonto, Mobil arbeiten.

Mehr über Campus Time

Campus Docs

Studienangebote und Modulhandbücher individuell zusammenstellen & downloaden.

Mehr über Campus Docs

Campus BITV

Seit 23. September 2020 muss Ihre Webseite auf Barrierefreiheit geprüft sein!

Mehr über Campus BITV

Campus Mails

Einfach massenweise Einzel-E-Mails DSGVO Konform an Empfänger aus CSV Exporten, LDAP oder Verteilerlisten senden. 

Mehr über Campus Mails