Descrizione dell'interfaccia
Generatore di biglietti
Tutti i seguenti attributi sono obbligatori. Le eccezioni sono etichettate come "opzionali".
| Attributo | Esempio / Formato | Spiegazione |
| semestre | 23S / 23W | Semestre Semestre estivo 23S o semestre invernale 23W |
| numero di immatricolazione | 123456 | Numero di matricola |
| saluto | m / f | Saluto m=maschio, f=femmina "Divers" non è possibile nell'OTS. È necessario selezionare m o f. |
| titolo | Dr. | Titolo (facoltativo) |
| nomeNome | Max Moritz | Nome(i) |
| Cognome | Uomo campione | Cognome(i) |
| data di nascita | 1990-09-07 | data di nascita |
| azienda | es. segreteria studenti | Azienda, può essere identica per tutti (facoltativo) |
| via | Piazza del castello | via |
| viaNumero | 2 | numero civico |
| codice postale | 12345 | codice postale |
| città | Città campione | città |
| Paese | DE | paese |
| telefono | 0123456789 | Telefono (opzionale) |
| max.mustermann@meine-uni.de | indirizzo e-mail | |
| pagamento | gratuito | Metodo di pagamento (secondo www.ots-nrw.de passo 3) |
| elv | vero | Si accetta l'addebito diretto? |
| privacyHs | vero | Si accetta lo scambio di dati con l'università ? |
| condizioni generali di contratto | vero | AGB accettato? |
| privacy | vero | Informativa sulla privacy accettata? |
Ulteriori spiegazioni
Per ordinare i biglietti è necessario accettare/riconoscere l'addebito diretto , i termini e le condizioni generali e l'informativa sulla privacy . L'ordine può essere eseguito solo se tutti e 4 gli attributi contengono il valore "true".
La nostra raccomandazione:
Chiedere agli utenti di accettare le seguenti condizioni e informazioni nell'applicazione. Nell'OTS, i seguenti testi sono visualizzati nella fase 5 dell'ordine e sono dotati di una casella di controllo.
elv: Confermo che l'importo totale deve essere addebitato sul mio conto/carta di credito. Semesterticket NRW non verrà addebitato.
privacyHs: Sì, l'università indicata può comunicare a DB Vertrieb GmbH se sono iscritto o meno al semestre in questione utilizzando i dati qui forniti.
agb + privacy: Accetto i termini e le condizioni generali e prendo atto delle informazioni sulla protezione dei dati .
Nota
Brain Appeal non è in grado di fornire una valutazione legale sull'obbligatorietà di inserire queste caselle nella domanda. In caso di dubbio, si consiglia di rivolgersi a un legale.
Esempio di richiesta con curl
Tutte le informazioni vengono trasferite al generatore di ticket tramite questa chiamata. In questo esempio, i dati vengono trasferiti tramite la riga di comando con cURL (informazioni su cURL con UbuntuLinux, cURL con Windows 10). Sono possibili anche altre forme e possono dipendere dal sistema utilizzato.
Variante leggibile:
| curl
| --header "Accept: application/json"
| --header "Content-Type: application/json"
| --request POST
| --data '{
| "semester": "20212",
| xml-ph-0032@deepl "123456",
| "salutation": "m",
| "title":",
| "firstName":"Max Moritz",
| "lastName": "Mustermann",
| "birthdate": "1990-09-07",
| "company":"",
| "via": "Schlossplatz",
| "streetNumber": "2",
| "postalCode":"12345",
| "città": "Musterstadt",
| "paese": "DE",
| "telefono": "0123456789",
| "email": "max.mustermann@meine-uni.de",
| "payment": "free",
| "elv": "true",
| "agb":"true",
| "privacy": "true",
| "privacyHs": "true"
| }'
| www.semestertickets.com
Compact version:
| 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.com
Valore di ritorno:
Se la generazione del biglietto ha successo, l'interfaccia restituisce un URL tramite il quale è possibile scaricare il biglietto in formato PDF.
La validità del link al PDF del biglietto è determinata dall'OTS. Raccomandazione: per motivi di prestazioni, memorizzare il biglietto nella cache locale.
Alternativa:
Dopo aver generato il ticket, questo può essere inviato all'indirizzo e-mail del cliente.
