8. Der RdvMedecins-Server, eine Blackbox
Die Beispiele 22 bis 25 sowie die Fallstudie interagieren mit einem Server: dem JSON-Server der Anwendung [RdvMedecins]. Es ist der [NestJS]-Server der Kurse [React], [Vue.js], [Angular] und [Flutter]: der Server des [NestJS]-Kurses, dessen Controller keine HTML-Seiten mehr erzeugen, sondern JSON-Antworten liefern. Die Leser dieser Lektionen kennen dieses Kapitel bereits; es wird hier nahezu unverändert wiedergegeben, und sie müssen nur den Abschnitt über die Authentifizierung lesen, der erklärt, was sich bei einer auf einem Telefon installierten [Ionic]-Anwendung ändert.
In diesem Kurs ist dieser Server eine Blackbox: Sie müssen nicht wissen, wie er geschrieben ist. Entscheidend ist allein seine API, also die Liste der HTTP-Anfragen, die er akzeptiert, und der Antworten, die er zurückgibt. Das ist die typische Situation eines Client-Entwicklers: Die API ist ein Vertrag, und das Serverteam kann hinter diesem Vertrag ändern, was es will. Sein Quellcode wird mitgeliefert ([rdvmedecins-nestjs-json]-Ordner) und ist ausführlich kommentiert, für den neugierigen Leser.
Dieses Kapitel erklärt, wie der Server installiert wird, beschreibt seine API und fragt sie mit [curl] ab.
8.1. Die Anwendung RdvMedecins
Die Anwendung verwaltet die Termine einer Arztpraxis. Sie kennt drei Rollen:
Rolle | Wer | Was sie tun können |
[ADMIN] | Der Administrator ([admin]) | Termine für alle Patienten anlegen und stornieren; Ärzte und Klienten verwalten |
[DOCTOR] | Ärzte ([pelissier], [tatou], [dupont]) | Termine für alle Patienten anlegen und stornieren; alle Namen in den Kalendern sehen |
[USER] | Patienten ([martin], [durand], [bistrou], [german]) | für sich selbst Termine buchen; ihre Termine stornieren; ihre Konten verwalten. In einem Kalender sehen sie die Namen anderer Patienten nicht |
Die Demo-Konten verwenden ihren Login als Passwort. Die Verwaltungsregeln werden vom Server geprüft, unabhängig vom Client:
- keine Termine in der Vergangenheit;
- nur ein bevorstehender Termin pro Patient;
- ein Zeitfenster kann pro Tag nur einmal gebucht werden;
- zwei Ärzte (oder zwei Klienten) dürfen nicht denselben Vor- und Nachnamen haben; ein Login gehört zu nur einem Konto;
- ein Arzt mit geplanten Terminen kann nicht gelöscht werden;
- Ein Datensatz, der in der Zwischenzeit von jemand anderem geändert wurde, kann nicht überschrieben werden (optimistisches Sperren);
- Einem Patienten wird nie der Name eines anderen Patienten zugewiesen.
8.2. Installation
Sie benötigen [Node.js] (bereits für [Angular] installiert; siehe Kapitel 2) und einen Server [MySQL] (oder [MariaDB]): Deren Installation wird im Anhang beschrieben.
1. Die Datenbank. Das Skript [database/dbrdvmedecins2.sql] erstellt die Datenbank [dbrdvmedecins2] samt Tabellen und Beispieldaten. Mit [Laragon] führen Sie es innerhalb von [HeidiSQL] aus (Menü Datei / SQL-Datei ausführen); in der Befehlszeile:
| mysql -u root -p < database/dbrdvmedecins2.sql
|
Das Skript beginnt immer mit einer leeren Datenbank: Sie können es erneut ausführen, um die Anfangsdaten wiederherzustellen.
2. Bibliotheken. In einem Konsolenfenster, das im Ordner [rdvmedecins-nestjs-json] geöffnet ist:
3. Konfiguration. Kopieren Sie die Datei [.env.example] nach [.env] (unter [Windows]: [copy .env.example .env]) und ändern Sie sie dann:
| # -----------------------------------------------------------------------
# Beispielkonfigurationsdatei.
# Kopieren Sie diese Datei nach [.env] und passen Sie dann die Werte an Ihren Rechner an.
# Die Datei [.env] darf niemals weitergegeben oder committet werden (Passwörter).
# -----------------------------------------------------------------------
# Port, auf dem der JSON-Server lauscht
PORT=8080
# Verbindungsparameter zur MySQL-Datenbank [dbrdvmedecins2]
# (Skript: database/dbrdvmedecins2.sql)
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=
DB_DATABASE=dbrdvmedecins2
# true: gibt die an MySQL gesendeten SQL-Abfragen in der Konsole aus
DB_LOGGING=false
# -----------------------------------------------------------------------
# Authentifizierung
# -----------------------------------------------------------------------
# geheimer Schlüssel zum Signieren/Prüfen der JWT-Token - MUSS geändert werden
# in der Produktion (eine lange Zufallszeichenkette, niemals committet).
JWT_SECRET=change-me-to-a-long-random-string
# Gültigkeitsdauer eines JWT-Tokens in Sekunden (7200 s = 2 h). Das Cookie,
# das den Token trägt, hat dieselbe Lebensdauer.
JWT_EXPIRES_IN_SECONDS=7200
# auf true setzen in der Produktion (über HTTPS bereitgestellte Website): Das Authentifizierungs-
# Cookie wird dann niemals über eine unverschlüsselte Verbindung gesendet.
COOKIE_SECURE=false
# -----------------------------------------------------------------------
# Schutz vor Bots
# -----------------------------------------------------------------------
# Anmeldung: Anzahl der erlaubten Fehlversuche (falsches CAPTCHA oder Passwort) für
# denselben Login von derselben IP-Adresse, bevor dieses Paar gesperrt wird ...
LOGIN_MAX_FAILURES=5
# ... für diese Dauer (eine IP-Adresse wird auch gesperrt, wenn sie fünfmal
# mehr Fehlversuche ansammelt, alle Logins zusammengezählt)
LOGIN_BLOCK_MINUTES=15
# Anlegen von Kundenkonten: maximale Anzahl der pro Stunde angelegten Konten
# von derselben IP-Adresse. In einem Klassenraum gehen oft alle Rechner
# über dieselbe Adresse ins Netz: bei Bedarf erhöhen.
REGISTRATION_MAX_PER_HOUR=10
# CAPTCHA-TESTMODUS: Hat diese Variable einen Wert, wird dieser Wert
# als Antwort auf JEDES CAPTCHA akzeptiert. Praktisch, um
# die API mit curl abzufragen (in einer Konsole kann man das Bild nicht "lesen").
# In der Produktion LEER lassen.
CAPTCHA_TEST=
# -----------------------------------------------------------------------
# Produktion
# -----------------------------------------------------------------------
# Ordner des kompilierten Web-Clients, der von diesem Server ausgeliefert wird (Standard: client/)
# CLIENT_DIR=client
# auf true setzen, wenn der Server hinter einem Proxy liegt (nginx ...)
TRUST_PROXY=false
|
- Zeile 8: Der Server lauscht auf Port 8080;
- Zeilen 12–16: die Verbindung zu [MySQL]. Mit [Laragon] hat der Benutzer [root] kein Passwort: Die Standardwerte passen;
- Zeile 25: der geheime Schlüssel, der die Authentifizierungstokens signiert;
- Zeilen 38–45: Anti-Bot-Maßnahmen: Nach 5 fehlgeschlagenen Anmeldeversuchen für denselben Benutzernamen von derselben IP-Adresse (IP) wird diese Kombination für 15 Minuten gesperrt; eine einzelne IP-Adresse (IP) kann nicht mehr als 10 Konten pro Stunde anlegen. Während der Anwendungsentwicklung – wenn Fehler häufig sind – finden Sie diese Werte in Ihrer [.env]-Datei;
- Zeile 51: der CAPTCHA-Testmodus. Die Anmeldeseite verlangt, die Zeichen aus einem Bild erneut einzutippen, was in einer Konsole unmöglich ist. Hat diese Variable einen Wert, wird dieser Wert als Antwort auf jedes CAPTCHA akzeptiert, genau wie die „Testschlüssel“, die [Google] für sein [reCAPTCHA] bereitstellt. Geben Sie für die Tests mit [curl] in diesem Kapitel [CAPTCHA_TEST=test] ein. Die Skripte, die die Screenshots für diesen Kurs erzeugt haben, verwenden diesen Wert ebenfalls. Lassen Sie ihn in der Produktion leer;
- Zeilen 57–59: zwei Einstellungen für die Produktion (siehe Kapitel „Bereitstellung“).
4. Start.
Die Konsole zeigt an (Auszug; [start:dev] startet den Server bei jeder Änderung seines Codes neu):
| [Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [NestFactory] Starting Nest application...
[Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [InstanceLoader] TypeOrmModule dependencies initialized +19ms
...
[Nest] 13189 - 10/06/2026, 1:29:56 PM WARN [RdvMedecins] captcha TEST MODE active (CAPTCHA_TEST in .env): never use it in production
[Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [RoutesResolver] ScheduleController {/api/schedule}: +1ms
[Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [RouterExplorer] Mapped {/api/schedule, GET} route +1ms
[Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [RoutesResolver] AppointmentsController {/api/appointments}: +0ms
...
[Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [RouterExplorer] Mapped {/api/auth/me, GET} route +0ms
[Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [NestApplication] Nest application successfully started +6ms
[Nest] 13189 - 10/06/2026, 1:29:56 PM LOG [RdvMedecins] JSON server started: http://localhost:8080/api
|
Jede Zeile [Mapped] kündigt eine Route der API an. Ist die Datenbank nicht erreichbar ([MySQL]-Server gestoppt, falsches Passwort), beendet sich der Server sofort mit einer Verbindungsfehlermeldung.
Alle Routen beginnen mit [/api]. Eine erfolgreiche Anfrage erhält einen Statuscode 2xx und in ihrem Body die angeforderten Daten im JSON-Format. Eine abgelehnte Anfrage erhält einen Statuscode 4xx oder 5xx und im Body Daten im selben Format:
| {
"statusCode": 400,
"key": "ERRORS.INVALID_FORM",
"params": { "min": "6" },
"fields": { "lastName": "ERRORS.LASTNAME_REQUIRED", "password": "ERRORS.PASSWORD_TOO_SHORT" }
}
|
- [statusCode]: der HTTP-Code, im Body wiederholt;
- [key]: der Übersetzungsschlüssel der Meldung. Der Server liefert niemals anzuzeigenden Text: Er kennt die Sprache des Benutzers nicht. Der Client übersetzt den Schlüssel anhand seiner Wörterbücher (siehe Beispiel 21);
- [params] (optional): Parameter der Meldung („Mindestens {{min}} Zeichen“, „Bitte versuchen Sie es in {{minutes}} Minute(n) erneut“;
- [fields] (optional): bei einem abgelehnten Formular der Fehler zu jedem Feld.
Verwendete Codes:
Code | Bedeutung | Beispiele für Schlüssel |
400 | Ungültige Anfrage | [ERRORS.INVALID_FORM] (+ fields), [ERRORS.INVALID_DATE], [ERRORS.WRONG_CAPTCHA], [ERRORS.CHOOSE_PATIENT], [ERRORS.WRONG_CURRENT_PASSWORD], [ERRORS.BAD_REQUEST] ... |
401 | Nicht authentifiziert | [ERRORS.AUTH_REQUIRED] (kein Token), [ERRORS.SESSION_EXPIRED] (ungültiges oder abgelaufenes Token), [LOGIN.ERROR] |
403 | Zugriff verweigert | [ERRORS.FORBIDDEN] (unzureichende Rolle), [ERRORS.CAPTCHA_BEFORE_ACCOUNT] (kein Pass) |
404 | Nicht gefunden | [ERRORS.NOT_FOUND], [ERRORS.DOCTOR_NOT_FOUND], [ERRORS.APPOINTMENT_NOT_FOUND] ... |
409 | Verletzung einer Geschäftsregel | [ERRORS.PAST_DATE], [ERRORS.SLOT_ALREADY_BOOKED], [ERRORS.LOGIN_TAKEN], [ERRORS.CONCURRENT_UPDATE] ... |
415 | POST, der nicht im Format JSON ist | [ERRORS.JSON_REQUIRED] |
429 | Zu viele Versuche | [ERRORS.TOO_MANY_ATTEMPTS], [ERRORS.TOO_MANY_ACCOUNTS] (+ params.minutes) |
500 | Serverfehler | [ERRORS.SERVER_ERROR] |
8.4. Authentifizierung
Der Client authentifiziert sich mit [POST /api/auth/login], mit Benutzername, Passwort und CAPTCHA-Antwort. Im Gegenzug sendet der Server im Header [Set-Cookie] seiner Antwort ein Cookie, das ein signiertes JWT-Token enthält:
| Set-Cookie: rdvmedecins_jwt=eyJhbGciOiJIUzI1NiIs...; Max-Age=7200; Path=/api; Expires=Tue, 06 Oct 2026 14:12:15 GMT; HttpOnly; SameSite=Strict
|
Der Client muss dieses Cookie anschließend im [Cookie]-Header bei jeder Anfrage an [/api] mitsenden: So weiß der Server, wer die Anfrage stellt.
Dieser Server wurde für Web-Clients entworfen, und seine Entwurfsentscheidungen richten sich nach den Risiken, die speziell Webbrowser betreffen:
- [HttpOnly]: Der [JavaScript]-Code der Seite kann dieses Cookie nicht lesen. Ein in die Seite eingeschleustes bösartiges Skript könnte das Token daher nicht stehlen. Folge für den Client: Er kann nicht selbst feststellen, ob er angemeldet ist. Er fragt den Server ([GET /api/auth/me]);
- [Path=/api]: Das Cookie wird nur an Anfragen an die API angehängt;
- [SameSite=Strict]: Der Browser hängt das Cookie nur an Anfragen an, die von einer Seite dieser Website gesendet werden. Eine bösartige Seite auf einer anderen Website kann den Browser nicht dazu bringen, im Namen des Benutzers zu handeln (ein sogenannter CSRF-Angriff);
- [Max-Age=7200]: Es läuft nach zwei Stunden ab, zugleich mit dem Token.
Eine zweite Absicherung gegen CSRF-Angriffe: Der Server weist (415) jede POST-Anfrage ab, deren Body nicht im Format JSON ist. Ein kompromittiertes HTML-Formular auf einer anderen Website kann kein JSON senden.
8.4.1. Was sich für einen mobilen Client ändert
Eine [Ionic]-App ist eine Web-App, die auf dem Telefon von einer „WebView“ ausgeführt wird (der Browser-Engine [Chrome] von [Android]): Folgt sie denselben Regeln wie ein Browser? In diesem Kurs müssen wir zwischen den beiden Arten ihrer Ausführung unterscheiden.
Im Browser des Computers während der Entwicklung ([ng serve]). Die Anwendung wird vom Entwicklungsserver von [Angular] ausgeliefert (http://localhost:8100); der JSON-Server läuft auf einem anderen Port (8080). Das sind zwei verschiedene Ursprünge, und der Browser würde zwei problematische Regeln anwenden: Er würde keine Antworten eines anderen Ursprungs akzeptieren, sofern der Server dies nicht erlaubt (der „CORS“-Mechanismus, den unser Server nicht unterstützt), und er würde das Cookie [SameSite=Strict] nicht an Anfragen „von einer anderen Website“ anhängen. Die Lösung ist dieselbe wie in den Kursen [React] und [Vue.js]: ein Proxy. Der Entwicklungsserver leitet jede Anfrage, deren Adresse mit [/api] beginnt, an den JSON-Server weiter (Datei [proxy.conf.json], siehe Beispiel 22). Aus Sicht des Browsers haben Anwendung und API denselben Ursprung: Der Browser speichert das Cookie und sendet es zurück, und der Code der Anwendung muss nichts tun.
Auf dem Telefon ([Android], [Capacitor]). Die Seite wird von [Capacitor] selbst ausgeliefert, von der Adresse https://localhost; der JSON-Server läuft auf dem Computer, unter einer Adresse wie http://10.0.2.2:8080 (siehe Beispiel 22). Wieder gibt es zwei Ursprünge. Das Projekt aktiviert das Plugin [CapacitorHttp] von [Capacitor] (Datei [capacitor.config.ts]): Die HTTP-Anfragen der Anwendung werden nicht mehr von der WebView gesendet, sondern vom nativen Code von [Android]. Folgen:
- Es gibt keine CORS-Prüfung mehr: Diese Prüfung ist eine Browser-Regel, und der native Code ist kein Browser (ebenso wenig wie [curl]);
- Die empfangenen Cookies werden von [Android] gespeichert (von dessen Cookie-Manager, demselben wie dem der WebView) und bei nachfolgenden Anfragen an denselben Server automatisch zurückgesendet. Sie bleiben auf dem Gerät erhalten: Sie bleiben angemeldet, wenn Sie die App schließen und erneut öffnen;
- die Attribute [HttpOnly] und [SameSite] verursachen keine Probleme: Der Code der Anwendung liest das Cookie nie (er fragt per [GET /api/auth/me], wer angemeldet ist), und die Anfrage wird nicht von einer Seite „von einer anderen Website“ gesendet.
Das ist ein wichtiger Unterschied zum Kurs [Flutter]: Eine [Flutter]-Anwendung hat keinen Browser und musste ihren eigenen HTTP-Client schreiben, der den Header [Set-Cookie] in den Antworten liest und den Header [Cookie] in die Anfragen schreibt. Mit [Ionic] wird das Cookie, sowohl im Browser als auch auf dem Telefon, ohne eine einzige Codezeile weitergereicht. Der Server seinerseits muss nichts ändern: Er sieht nur gewöhnliche HTTP-Anfragen, die das von ihm gesetzte Cookie enthalten.
8.5. Die API
Methode | Adresse | Rollen | Gesendeter Body / Antwort |
GET | [/api/captcha] | öffentlich | Antwort: [{ id, svg }] |
POST | [/api/auth/login] | öffentlich | [{ login, password, captchaId, captcha }]; Antwort: [{ login, name, role }] + Cookie |
POST | [/api/auth/logout] | öffentlich | [{}] ; löscht das Cookie |
GET | [/api/auth/me] | angemeldet | Antwort: [{ login, name, role }] |
GET | [/api/schedule?doctorId=&day=] | alle | Antwort: der Kalender (ohne doctorId: bei einem DOCTOR sein eigener) |
POST | [/api/appointments] | alle | [{ day, slotId, clientId }] (clientId ignoriert bei einem USER); 201 |
DELETE | [/api/appointments/:id] | alle | Ein USER storniert nur seine eigenen |
GET | [/api/doctors] | alle | die Liste (mit login für ADMIN) |
GET | [/api/clients] | ADMIN, DOCTOR | die Liste (mit login für ADMIN) |
GET | [/api/doctors/:id], [/api/clients/:id] | ADMIN | ein Datensatz |
POST | [/api/doctors], [/api/clients] | ADMIN | [{ title, firstName, lastName, login?, password? }]; 201 |
PUT | [/api/doctors/:id], [/api/clients/:id] | ADMIN | [{ title, firstName, lastName, login?, password?, version }] |
DELETE | [/api/doctors/:id], [/api/clients/:id] | ADMIN | Antwort: [{}] |
POST | [/api/register/access] | öffentlich | [{ captchaId, captcha }]; stellt ein Token aus (Cookie) |
GET | [/api/register/access] | öffentlich | Antwort: [{ valid }] |
POST | [/api/register] | öffentlich + Pass | [{ title, firstName, lastName, login, password, confirmation }]; 201 |
GET | [/api/my-area] | USER | Antwort: [{ patient, appointments }] |
GET | [/api/my-account] | USER | Antwort: [{ title, firstName, lastName, login, version }] |
PUT | [/api/my-account] | USER | [{ title, firstName, lastName, login, password?, confirmation?, currentPassword, version }] |
DELETE | [/api/my-account] | USER | [{ currentPassword }]; löscht das Konto und seine Termine |
Ein Eintrag des Kalenders ([GET /api/schedule]) beschreibt ein Zeitfenster UND das, was der angemeldete Benutzer damit tun darf:
| { "id": 3, "startHour": 8, "startMinute": 40, "endHour": 9, "endMinute": 0,
"free": false,
"patient": { "title": "Mme", "firstName": "Alice", "lastName": "DURAND" },
"mine": false, "bookable": false, "appointmentId": 2 }
|
- [free]: Ist das Zeitfenster an diesem Tag verfügbar?
- [patient]: der Patient des Termins. Bei einem angemeldeten Patienten ist dies gleich [null], außer bei SEINEM EIGENEN (Termin): Die Namen anderer Patienten werden nie gesendet;
- [mine]: Dies ist der Termin des angemeldeten Patienten;
- [bookable]: Kann der Benutzer dieses Zeitfenster buchen (verfügbar, nicht in der Vergangenheit und, bei einem Patienten, kein bevorstehender Termin)?
- [appointmentId]: ausgefüllt, wenn der Benutzer diesen Termin stornieren kann.
Der Server ENTSCHEIDET; der Client zeigt an. Und selbst wenn ein Client schummelte (indem er eine Schaltfläche „Buchen“ anzeigt, obwohl er es nicht sollte), würde der Server bei der Buchung alles noch einmal prüfen.
8.6. Die API mit curl abfragen
Der [curl]-Ordner auf dem Server enthält die JSON-Bodys der Anfragen dieses Kapitels, eine Datei pro Anfrage. Zum Beispiel [curl/login-admin.json]:
| { "login": "admin", "password": "admin", "captchaId": "-", "captcha": "test" }
|
Die Befehle werden in einer Konsole eingegeben, die im Verzeichnis [rdvmedecins-nestjs-json] geöffnet ist, bei laufendem Server im CAPTCHA-Testmodus ([CAPTCHA_TEST=test]) auf einer soeben (neu) initialisierten Datenbank. Einige Optionen von [curl]:
- [-i]: zusätzlich die Antwort-Header anzeigen; [-s]: ohne Fortschrittsanzeige;
- [--json @file]: den Inhalt der Datei per POST senden, mit dem Header [Content-Type: application/json] ([curl] 7.82 und höher; bei einer älteren Version verwenden Sie [-H "Content-Type: application/json" -d @file]);
- [-X PUT], [-X DELETE]: die HTTP-Methode;
- [-c cookies.txt]: die empfangenen Cookies in dieser Datei speichern; [-b cookies.txt]: sie zurücksenden. So „bleibt“ [curl] von einem Befehl zum nächsten „angemeldet“, genau wie es ein Browser täte.
Unter [PowerShell] müssen Sie [curl.exe] und nicht [curl] eingeben (das für einen anderen Befehl steht). Die folgende Ausgabe stammt aus einer echten Sitzung (6. Oktober 2026, mit für Januar 2030 geplanten Terminen, damit sie noch in der Zukunft liegen). Die etwas langen JSON-Antworten wurden für dieses Dokument formatiert (eine Zeile pro Objekt), während die JWT-Tokens und das CAPTCHA-Bild gekürzt wurden („...“), und die Header [Date], [ETag], [Connection] und [Keep-Alive] entfernt wurden.
8.6.1. Anmeldung
Zuerst das CAPTCHA (das Bild ist gekürzt):
| $ curl -i http://localhost:8080/api/captcha
HTTP/1.1 200 OK
Cache-Control: no-store
Content-Type: application/json; charset=utf-8
Content-Length: 13195
{"id":"8f711d55-566c-44e6-b02b-f114a02279f6","svg":"<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"150..."}
|
Ohne Token liefert eine geschützte URL eine Antwort 401:
| $ curl -i http://localhost:8080/api/doctors
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
Content-Length: 47
{"statusCode":401,"key":"ERRORS.AUTH_REQUIRED"}
|
Ein falsches CAPTCHA, gefolgt von einem falschen Passwort:
| $ curl -i --json @curl/login-wrong-captcha.json http://localhost:8080/api/auth/login
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 91
{"statusCode":400,"key":"ERRORS.WRONG_CAPTCHA","fields":{"captcha":"ERRORS.WRONG_CAPTCHA"}}
|
| $ curl -i --json @curl/login-wrong-password.json http://localhost:8080/api/auth/login
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
Content-Length: 38
{"statusCode":401,"key":"LOGIN.ERROR"}
|
Eine erfolgreiche Anmeldung setzt das Cookie, das [curl] in [cookies.txt] speichert:
| $ curl -i -c cookies.txt --json @curl/login-admin.json http://localhost:8080/api/auth/login
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=eyJhbGciOiJIUzI1NiIs...; Max-Age=7200; Path=/api; Expires=Tue, 06 Oct 2026 14:12:15 GMT; HttpOnly; SameSite=Strict
Content-Type: application/json; charset=utf-8
Content-Length: 55
{"login":"admin","name":"Administrator","role":"ADMIN"}
|
Mit diesem Cookie weiß der Server, wer wir sind:
| $ curl -i -b cookies.txt http://localhost:8080/api/auth/me
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 55
{"login":"admin","name":"Administrator","role":"ADMIN"}
|
Ein gefälschtes (oder abgelaufenes) Token führt zu einer abgelaufenen Sitzung, und der Server fordert an, dass das Cookie gelöscht wird (ein abgelaufenes Ablaufdatum):
| $ curl -i -b "rdvmedecins_jwt=abc.def.ghi" http://localhost:8080/api/auth/me
HTTP/1.1 401 Unauthorized
Set-Cookie: rdvmedecins_jwt=; Path=/api; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 49
{"statusCode":401,"key":"ERRORS.SESSION_EXPIRED"}
|
8.6.2. Ärzte, Klienten, Kalender
Die Liste der Ärzte, wie ADMIN sie sieht (mit Logins):
| $ curl -i -b cookies.txt http://localhost:8080/api/doctors
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 282
[
{"id":3,"version":0,"title":"Melle","firstName":"Sophie","lastName":"DUPONT","login":"dupont"},
{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER","login":"pelissier"},
{"id":2,"version":0,"title":"Mr","firstName":"Paul","lastName":"TATOU","login":"tatou"}
]
|
Der Kalender von Dr. PELISSIER für den 15. Januar 2030:
| $ curl -s -b cookies.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-01-15"
{
"doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
"day":"2030-01-15",
"slots":[
{"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
],
"info":null
}
|
Ein Datum, das nicht existiert:
| $ curl -i -b cookies.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-02-30"
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 46
{"statusCode":400,"key":"ERRORS.INVALID_DATE"}
|
8.6.3. Termine
ADMIN reserviert Zeitfenster 3 für Patient Nr. 2 (Alice DURAND). Der Body der Anfrage ([curl/appointment-admin.json]):
| { "day": "2030-01-15", "slotId": 3, "clientId": 2 }
|
| $ curl -i -b cookies.txt --json @curl/appointment-admin.json http://localhost:8080/api/appointments
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: 51
{"id":2,"day":"2030-01-15","slotId":3,"clientId":2}
|
Der Kalender zeigt nun diesen Termin an, zusammen mit dem Namen des Patienten und der Angabe, wie er storniert werden kann ([appointmentId]):
| $ curl -s -b cookies.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-01-15"
{
"doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
"day":"2030-01-15",
"slots":[
{"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":false,"patient":{"title":"Mme","firstName":"Alice","lastName":"DURAND"},"mine":false,"bookable":false,"appointmentId":2},
{"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
],
"info":null
}
|
Versuchen Sie es erneut: Der Patient hat bereits einen bevorstehenden Termin. Ein Termin in der Vergangenheit (15. Januar 2020, Datei [curl/appointment-past.json]) wird ebenfalls abgelehnt:
| $ curl -i -b cookies.txt --json @curl/appointment-admin.json http://localhost:8080/api/appointments
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 66
{"statusCode":409,"key":"ERRORS.PATIENT_HAS_UPCOMING_APPOINTMENT"}
|
| $ curl -i -b cookies.txt --json @curl/appointment-past.json http://localhost:8080/api/appointments
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 43
{"statusCode":409,"key":"ERRORS.PAST_DATE"}
|
Ein normales HTML-Formular (hier simuliert durch [-d], das [application/x-www-form-urlencoded] sendet) wird abgelehnt:
| $ curl -i -b cookies.txt -d "day=2030-01-15&slotId=4&clientId=2" http://localhost:8080/api/appointments
HTTP/1.1 415 Unsupported Media Type
Content-Type: application/json; charset=utf-8
Content-Length: 47
{"statusCode":415,"key":"ERRORS.JSON_REQUIRED"}
|
8.6.4. Aus Sicht eines Patienten
Sie melden sich ab und dann als [martin] an:
| $ curl -i -b cookies.txt -c cookies.txt --json @curl/empty.json http://localhost:8080/api/auth/logout
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=; Path=/api; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 2
{}
|
| $ curl -s -c cookies-martin.txt --json @curl/login-martin.json http://localhost:8080/api/auth/login
{"login":"martin","name":"Jean MARTIN","role":"USER"}
|
Derselbe Kalender, wie ihn ein Patient sieht: Zeitfenster 3 ist belegt (["free":false]), aber ["patient"] ist gleich [null]: Der Name von Alice (DURAND) wurde nicht gesendet:
| $ curl -s -b cookies-martin.txt "http://localhost:8080/api/schedule?doctorId=1&day=2030-01-15"
{
"doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
"day":"2030-01-15",
"slots":[
{"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":false,"patient":null,"mine":false,"bookable":false,"appointmentId":null},
{"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
],
"info":null
}
|
Ein Patient hat keinen Zugriff auf die Klientenliste:
| $ curl -i -b cookies-martin.txt http://localhost:8080/api/clients
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 43
{"statusCode":403,"key":"ERRORS.FORBIDDEN"}
|
Er bucht für sich selbst (der Datensatz [curl/appointment-martin.json] enthält kein [clientId]), einmal, nicht zweimal ([curl/appointment-martin-2.json]: am nächsten Tag, Zeitfenster 6):
| { "day": "2030-01-15", "slotId": 5 }
|
| $ curl -i -b cookies-martin.txt --json @curl/appointment-martin.json http://localhost:8080/api/appointments
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: 51
{"id":3,"day":"2030-01-15","slotId":5,"clientId":1}
|
| $ curl -i -b cookies-martin.txt --json @curl/appointment-martin-2.json http://localhost:8080/api/appointments
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 55
{"statusCode":409,"key":"SCHEDULE.ALREADY_BOOKED_INFO"}
|
Sein Bereich:
| $ curl -s -b cookies-martin.txt http://localhost:8080/api/my-area
{
"patient":{"title":"Mr","firstName":"Jean","lastName":"MARTIN"},
"appointments":[
{
"id":3,
"day":"2030-01-15",
"slot":{"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40},
"doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"}
}
]
}
|
Er kann den Termin eines anderen Patienten nicht stornieren. Der Server antwortet mit „nicht gefunden“, genau wie bei einem Termin, der nicht existiert: Er verrät nichts über die Termine anderer Patienten:
| $ curl -i -b cookies-martin.txt -X DELETE http://localhost:8080/api/appointments/2
HTTP/1.1 404 Not Found
Content-Type: application/json; charset=utf-8
Content-Length: 55
{"statusCode":404,"key":"ERRORS.APPOINTMENT_NOT_FOUND"}
|
Den eigenen schon:
| $ curl -i -b cookies-martin.txt -X DELETE http://localhost:8080/api/appointments/3
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 2
{}
|
8.6.5. Aus Sicht eines Arztes
Dr. PELISSIER meldet sich an:
| $ curl -s -c cookies-pelissier.txt --json @curl/login-pelissier.json http://localhost:8080/api/auth/login
{"login":"pelissier","name":"Marie PELISSIER","role":"DOCTOR"}
|
Ohne [doctorId] erhält ein angemeldeter Arzt seinen EIGENEN Kalender, mit allen Namen (der Termin von [martin] wurde gerade storniert: Der Termin von Alice, DURAND, bleibt bestehen):
| $ curl -s -b cookies-pelissier.txt "http://localhost:8080/api/schedule?day=2030-01-15"
{
"doctor":{"id":1,"version":0,"title":"Mme","firstName":"Marie","lastName":"PELISSIER"},
"day":"2030-01-15",
"slots":[
{"id":1,"startHour":8,"startMinute":0,"endHour":8,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":2,"startHour":8,"startMinute":20,"endHour":8,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":3,"startHour":8,"startMinute":40,"endHour":9,"endMinute":0,"free":false,"patient":{"title":"Mme","firstName":"Alice","lastName":"DURAND"},"mine":false,"bookable":false,"appointmentId":2},
{"id":4,"startHour":9,"startMinute":0,"endHour":9,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":5,"startHour":9,"startMinute":20,"endHour":9,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":6,"startHour":9,"startMinute":40,"endHour":10,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":7,"startHour":10,"startMinute":0,"endHour":10,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":8,"startHour":10,"startMinute":20,"endHour":10,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":9,"startHour":10,"startMinute":40,"endHour":11,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":10,"startHour":11,"startMinute":0,"endHour":11,"endMinute":20,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":11,"startHour":11,"startMinute":20,"endHour":11,"endMinute":40,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null},
{"id":12,"startHour":11,"startMinute":40,"endHour":12,"endMinute":0,"free":true,"patient":null,"mine":false,"bookable":true,"appointmentId":null}
],
"info":null
}
|
Er verwaltet keine Ärzte:
| $ curl -i -b cookies-pelissier.txt --json @curl/doctor-add.json http://localhost:8080/api/doctors
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 43
{"statusCode":403,"key":"ERRORS.FORBIDDEN"}
|
8.6.6. Ärzte und Klienten verwalten (ADMIN)
ADMIN meldet sich erneut an (er hatte sich zuvor abgemeldet):
| $ curl -s -c cookies.txt --json @curl/login-admin.json http://localhost:8080/api/auth/login
{"login":"admin","name":"Administrator","role":"ADMIN"}
|
Ein Hinzufügen. Fehlt der Login, ist der Standardwert der Name in Kleinbuchstaben; das Passwort ist der Login ([curl/doctor-add.json]):
| { "title": "Mme", "firstName": "Claire", "lastName": "LEROY" }
|
| $ curl -i -b cookies.txt --json @curl/doctor-add.json http://localhost:8080/api/doctors
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Content-Length: 90
{"id":4,"version":1,"title":"Mme","firstName":"Claire","lastName":"LEROY","login":"leroy"}
|
Ungültiger Body: Die Antwort listet den Fehler zu jedem Feld auf ([curl/doctor-invalid.json]):
| { "title": "Dr", "firstName": "", "lastName": "A-LAST-NAME-FAR-TOO-LONG-FOR-THE-DB", "login": "Claire L" }
|
| $ curl -i -b cookies.txt --json @curl/doctor-invalid.json http://localhost:8080/api/doctors
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 218
{
"statusCode":400,
"key":"ERRORS.INVALID_FORM",
"params":{"min":"6"},
"fields":{"login":"ERRORS.INVALID_LOGIN","title":"ERRORS.INVALID_TITLE","firstName":"ERRORS.FIRSTNAME_REQUIRED","lastName":"ERRORS.LASTNAME_TOO_LONG"}
}
|
Ein Namensvetter (Herr Paul TATOU, [curl/doctor-duplicate.json]): Beide betroffenen Felder werden markiert:
| $ curl -i -b cookies.txt --json @curl/doctor-duplicate.json http://localhost:8080/api/doctors
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 151
{
"statusCode":409,
"key":"ERRORS.DOCTOR_ALREADY_EXISTS",
"fields":{"firstName":"ERRORS.DOCTOR_ALREADY_EXISTS","lastName":"ERRORS.DOCTOR_ALREADY_EXISTS"}
}
|
Eine Änderung. [version] ist die zusammen mit dem Datensatz gelesene (hier 1, [curl/doctor-edit.json]):
| { "title": "Mme", "firstName": "Claire", "lastName": "LEROY-MARTIN", "version": 1 }
|
| $ curl -i -b cookies.txt -X PUT --json @curl/doctor-edit.json http://localhost:8080/api/doctors/4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 97
{"id":4,"version":2,"title":"Mme","firstName":"Claire","lastName":"LEROY-MARTIN","login":"leroy"}
|
Der Datensatz hat nun die Version 2. Dieselbe Änderung (mit Version 1) erneut zu senden, würde einen Datensatz überschreiben, der inzwischen von jemand anderem geändert wurde: Genau das verhindert das optimistische Sperren:
| $ curl -i -b cookies.txt -X PUT --json @curl/doctor-edit.json http://localhost:8080/api/doctors/4
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 51
{"statusCode":409,"key":"ERRORS.CONCURRENT_UPDATE"}
|
Ein Arzt mit Terminen kann nicht gelöscht werden; die anderen schon:
| $ curl -i -b cookies.txt -X DELETE http://localhost:8080/api/doctors/1
HTTP/1.1 409 Conflict
Content-Type: application/json; charset=utf-8
Content-Length: 57
{"statusCode":409,"key":"ERRORS.DOCTOR_HAS_APPOINTMENTS"}
|
| $ curl -i -b cookies.txt -X DELETE http://localhost:8080/api/doctors/4
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 2
{}
|
8.6.7. Ein Konto anlegen
Ohne Pass ist es unmöglich:
| $ curl -i --json @curl/registration.json http://localhost:8080/api/register
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 56
{"statusCode":403,"key":"ERRORS.CAPTCHA_BEFORE_ACCOUNT"}
|
Zuerst lösen Sie ein CAPTCHA ([curl/captcha-test.json]: [{ "captchaId": "-", "captcha": "test" }]); der Server stellt in einem Cookie ein Token aus, das 15 Minuten gültig ist:
| $ curl -i -c cookies-registration.txt --json @curl/captcha-test.json http://localhost:8080/api/register/access
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_registration=d2f6290a-b277-4785-9fd9-fada3be36087; Max-Age=900; Path=/api/register; Expires=Tue, 06 Oct 2026 12:27:16 GMT; HttpOnly; SameSite=Strict
Content-Type: application/json; charset=utf-8
Content-Length: 2
{}
|
| $ curl -s -b cookies-registration.txt http://localhost:8080/api/register/access
{"valid":true}
|
Die Passwortbestätigung muss identisch sein ([curl/registration-confirmation.json]: „secret1“, dann „secret2“):
| $ curl -i -b cookies-registration.txt --json @curl/registration-confirmation.json http://localhost:8080/api/register
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 98
{"statusCode":400,"key":"ERRORS.INVALID_FORM","fields":{"confirmation":"ERRORS.PASSWORDS_DIFFER"}}
|
Der korrekte Body ([curl/registration.json]):
| { "title": "Mme", "firstName": "Julie", "lastName": "BERNARD", "login": "jbernard", "password": "secret1", "confirmation": "secret1" }
|
| $ curl -i -b cookies-registration.txt -c cookies-registration.txt --json @curl/registration.json http://localhost:8080/api/register
HTTP/1.1 201 Created
Set-Cookie: rdvmedecins_registration=; Path=/api/register; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 20
{"login":"jbernard"}
|
Der Pass wurde verbraucht: Mit ihm lässt sich kein zweites Konto anlegen:
| $ curl -i -b cookies-registration.txt --json @curl/registration.json http://localhost:8080/api/register
HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
Content-Length: 56
{"statusCode":403,"key":"ERRORS.CAPTCHA_BEFORE_ACCOUNT"}
|
8.6.8. Das eigene Konto verwalten
Die neue Patientin meldet sich an und liest ihren Datensatz:
| $ curl -s -c cookies-jbernard.txt --json @curl/login-jbernard.json http://localhost:8080/api/auth/login
{"login":"jbernard","name":"Julie BERNARD","role":"USER"}
|
| $ curl -s -b cookies-jbernard.txt http://localhost:8080/api/my-account
{"title":"Mme","firstName":"Julie","lastName":"BERNARD","login":"jbernard","version":1}
|
Eine Änderung erfordert das aktuelle Passwort. Der Server stellt ein neues Token aus, das den neuen Namen enthält ([curl/my-account.json]):
| { "title": "Mme", "firstName": "Julie", "lastName": "BERNARD-DUVAL", "login": "jbernard", "currentPassword": "secret1", "version": 1 }
|
| $ curl -i -b cookies-jbernard.txt -c cookies-jbernard.txt -X PUT --json @curl/my-account.json http://localhost:8080/api/my-account
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=eyJhbGciOiJIUzI1NiIs...; Max-Age=7200; Path=/api; Expires=Tue, 06 Oct 2026 14:12:17 GMT; HttpOnly; SameSite=Strict
Content-Type: application/json; charset=utf-8
Content-Length: 63
{"login":"jbernard","name":"Julie BERNARD-DUVAL","role":"USER"}
|
Das Löschen des Kontos ([curl/my-account-delete.json]: [{ "currentPassword": "secret1" }]) löscht auch das Cookie:
| $ curl -i -b cookies-jbernard.txt -c cookies-jbernard.txt -X DELETE --json @curl/my-account-delete.json http://localhost:8080/api/my-account
HTTP/1.1 200 OK
Set-Cookie: rdvmedecins_jwt=; Path=/api; Expires=Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 2
{}
|
| $ curl -i -b cookies-jbernard.txt http://localhost:8080/api/auth/me
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
Content-Length: 47
{"statusCode":401,"key":"ERRORS.AUTH_REQUIRED"}
|
8.6.9. Einige Fehler
Eine unbekannte Route, ein Body, der kein gültiges JSON ist:
| $ curl -i -b cookies-martin.txt http://localhost:8080/api/does-not-exist
HTTP/1.1 404 Not Found
Content-Type: application/json; charset=utf-8
Content-Length: 43
{"statusCode":404,"key":"ERRORS.NOT_FOUND"}
|
| $ curl -i -b cookies.txt -H "Content-Type: application/json" -d "{not json" http://localhost:8080/api/appointments
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
Content-Length: 45
{"statusCode":400,"key":"ERRORS.BAD_REQUEST"}
|
Wir wissen nun alles Wesentliche über den Server, um unseren Client zu schreiben.