Descripción de la interfaz
Generador de billetes
Todos los atributos siguientes son obligatorios. Las excepciones se etiquetan como "opcionales".
| Atributo | Ejemplo / Formato | Explicación |
| semestre | 23S / 23W | Semestre Semestre de verano 23S o semestre de invierno 23W |
| matriculaciónNúmero | 123456 | Número de matrícula |
| saludo | m / f | Saludo m=masculino, f=femenino "Divers" no es posible en la OET. Debe seleccionar m o f. |
| título | Dr. | Título (opcional) |
| firstName | Max Moritz | Nombre(s) |
| apellido | Sample man | Apellido(s) |
| fecha de nacimiento | 1990-09-07 | fecha de nacimiento |
| empresa | p.ej. secretaría de estudiantes | Empresa, puede ser idéntica para todos (opcional) |
| calle | plaza del castillo | calle |
| streetNumber | 2 | número de casa |
| código postal | 12345 | código postal |
| ciudad | Muestra de ciudad | ciudad |
| país | DE | país |
| teléfono | 0123456789 | Teléfono (opcional) |
| correo electrónico | max.mustermann@meine-uni.de | dirección de correo electrónico |
| pago | gratis | Forma de pago (según www.ots-nrw.de paso 3) |
| elv | verdadero | ¿Se acepta domiciliación bancaria? |
| privacidadHs | true | ¿Se acepta el intercambio de datos con la universidad ? |
| condiciones generales | true | AGB ¿aceptada? |
| privacidad | true | ¿Política de privacidad aceptada? |
Más explicaciones
Para pedir entradas, es necesario aceptar / reconocer las domiciliación bancaria, condiciones generales y política de privacidad. El pedido sólo puede ejecutarse si los 4 atributos de contienen el valor "true".
Nuestra recomendación:
Haga que los usuarios acepten las siguientes condiciones e información en la aplicación. En la OET, los siguientes textos se muestran en el paso 5 de la orden y cada uno de ellos está provisto de una casilla de verificación.
elv: Por la presente confirmo que el importe total se cargará en mi cuenta / tarjeta de crédito. No se realizará ningún cargo en Semesterticket NRW.
privacyHs: Sí, la universidad indicada puede informar a DB Vertrieb GmbH si estoy matriculado o no en el semestre en cuestión utilizando los datos aquí facilitados.
agb +privacy: Acepto las condiciones generales y tomo nota de la información sobre protección de datos .
Nota
Brain Appeal no puede proporcionar una evaluación legal sobre si estas casillas deben incluirse en su solicitud. En caso de duda, solicite asesoramiento jurídico.
Ejemplo de solicitud con curl
Toda la información se transfiere al generador de tickets a través de esta llamada. En este ejemplo, los datos se transfieren a través de la línea de comandos con cURL (información sobre cURL con UbuntuLinux, cURL con Windows 10). Otras formas también son posibles y pueden depender del sistema utilizado.
Variante legible:
| 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":"",
| "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"
| }'
| www.semestertickets.com
Versión compacta:
| 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
Valor de retorno:
Si la generación del billete se realiza correctamente, la interfaz devuelve una URL a través de la cual se puede descargar el billete en formato PDF.
La validez del enlace al PDF del ticket viene determinada por la OET. Recomendación: Por motivos de rendimiento, almacene el ticket en cachés locales.
Alternativa:
Una vez generado el ticket, éste puede enviarse a la dirección de correo electrónico del cliente.
