OBS/Kostenpflichtige Module/RESTServer/Beispiel5 - Versionsgeschichte

Rademacker am 9. September 2026 um 12:31 Uhr

2026-09-09T12:31:25Z

Rademacker am 1. September 2026 um 09:11 Uhr

2026-09-01T09:11:24Z

@@ Zeile 158: / Zeile 158: @@
          end;
-         AuftragSpeichern(cUid, oBody);   // setzt Version auf nAktuell + 1
+         // AuftragSpeichern gibt den Rueckgabewert von SaveData durch. Ohne
          oHdr := TJSONObject.Create();
          oHdr.AddPair('ETag', xStr(nAktuell + 1));
@@ Zeile 216: / Zeile 226: @@
          //    umschliesst diesen Block nicht.
          cNeueUid := MaterialAnlegen(cUid, cArtikel, nMenge);
          // 3) Antwort vollständig aufbauen - genau sie wird eingefroren und bei
@@ Zeile 350: / Zeile 375: @@
 ==Was zeigt das Beispiel?==
-* Echte HTTP-Statuscodes aus dem Skript: 201, 403, 404, 409, 422.
+* Echte HTTP-Statuscodes aus dem Skript: 201, 403, 404, 409, 422, 500.
 * Optimistic Concurrency über ''ETag'' (GET) und ''If-Match'' (PUT) -> 409 VERSION_CONFLICT.
 * Idempotente Schreibzugriffe über den ''Idempotency-Key'' - '''vom Server erledigt''', das Skript enthält dafür keine Zeile Code.

Rademacker am 19. August 2026 um 12:01 Uhr

2026-08-19T12:01:01Z

← Nächstältere Version		Version vom 19. August 2026, 13:01 Uhr
Zeile 11:		Zeile 11:
	** API-Key: zufällig generiert		** API-Key: zufällig generiert
	** JWT aktiv, JWT-Endpunkt ''auth'', JWT-Key zufällig, JWT-Exp 60 (Minuten)		** JWT aktiv, JWT-Endpunkt ''auth'', JWT-Key zufällig, JWT-Exp 60 (Minuten)
	* '''Endpunkte''' (~~alle~~ dem Profil ''Public-API'' zugeordnet):		* '''Endpunkte''' (beide dem Profil ''Public-API'' zugeordnet):
	** ''orders/{uid}'' - Auftrag lesen/Ändern		** ''orders/{uid}'' - Auftrag lesen/Ändern
	** ''orders/{uid}/material'' - Material erfassen		** ''orders/{uid}/material'' - Material erfassen
	** ''auth/logout'' - Abmelden		* '''Berechtigung:''' Zugang ''Mobile-App'' für beide Endpunkte freigeschaltet
	* '''Berechtigung:''' Zugang ''Mobile-App'' für ~~alle drei~~ Endpunkte freigeschaltet
			{{Hinweis\|Für das Abmelden gibt es '''keinen eigenen Endpunkt'''. Es läuft über
			ein ''DELETE'' auf den JWT-Endpunkt ''auth'' und braucht daher weder eine Zeile
			in ''RESTSRV_ENDPOINTS'' noch eine Berechtigung.}}

	==JWT-Authentifizierungs-Skript (Zugang)==		==JWT-Authentifizierungs-Skript (Zugang)==
Zeile 67:		Zeile 70:
	oRes := TJSONObject.Create();		oRes := TJSONObject.Create();
	try		try

	cUser := oParams.Values['_OBS_JWT_SUBJECT'];		cUser := oParams.Values['_OBS_JWT_SUBJECT'];

Zeile 82:		Zeile 84:
	// Mandant und Rollen NEU lesen, nicht aus dem alten Token uebernehmen -		// Mandant und Rollen NEU lesen, nicht aus dem alten Token uebernehmen -
	// sonst wirkt ein Rechteentzug erst beim naechsten Login.		// sonst wirkt ein Rechteentzug erst beim naechsten Login.

	oRes.AddPair('status' , 1);		oRes.AddPair('status' , 1);
	oRes.AddPair('_OBS_JWT_ID' , cUser);		oRes.AddPair('_OBS_JWT_ID' , cUser);
Zeile 227:		Zeile 228:
	</syntaxhighlight>		</syntaxhighlight>

	==Endpunkt ~~''auth/logout'' - Abmelden~~==		==Abmelden - ohne Endpunkt und ohne Skript==

	Beim Abmelden soll das Gerät seine Sitzung wirklich verlieren - nicht erst mit dem		Beim Abmelden soll das Gerät seine Sitzung wirklich verlieren, nicht erst mit dem
	Ablauf des Tokens. Dafür genügt ~~ein Antwortfeld; die Sperre führt~~ der Server in		Ablauf des Tokens. Dafür ist '''nichts einzurichten''': ein ''DELETE'' auf den
	''RESTSRV_TOKEN'':		JWT-Endpunkt mit dem Access-Token genügt, der Server sperrt die Sitzung in
			''RESTSRV_TOKEN'' und antwortet 204.

			Gesperrt wird die ganze Sitzung, also auch die Access-Token vorheriger
			Erneuerungen. Ein zweiter Aufruf ist unschädlich und bleibt 204. Kann der Server
			die Sitzung nicht sperren, antwortet er '''503''' mit ''Retry-After'' - die App
			wiederholt den Abmeldevorgang dann.

			Nur wenn beim Abmelden zusätzlich etwas passieren soll - hier: die
			Geräteregistrierung für Push löschen -, braucht es einen eigenen Endpunkt. Er
			erledigt seine Fachlogik und setzt ''_OBS_JWT_REVOKE'':

	<syntaxhighlight lang="pascal" line>		<syntaxhighlight lang="pascal" line>
	function Post(oParams: TStrings; oBody: TJSONObject): string;		function Post(oParams: TStrings; oBody: TJSONObject): string;
	var oRes: TJSONObject;		var oRes : TJSONObject;
	oVal: TJSONValue;		oVal : TJSONValue;
	cAlle: string;		cAlle: string;
	begin		begin
	oRes := TJSONObject.Create();		oRes := TJSONObject.Create();
	try		try
	// Optional: {"alleGeraete": true} meldet den Techniker ueberall ab		PushRegistrierungLoeschen(oParams.Values['_OBS_JWT_CLAIM_technikerUid']);

			// Optional: {"alleGeraete": true} meldet den Techniker ueberall ab.
			// Diese Entscheidung gehoert bewusst in ein Skript - sie braucht eine
			// Berechtigungspruefung, die der JWT-Endpunkt nicht leisten kann.
	cAlle := 'session';		cAlle := 'session';
	if (Assigned(oBody)) then begin		if (Assigned(oBody)) then begin
Zeile 258:		Zeile 273:
	end;		end;
	</syntaxhighlight>		</syntaxhighlight>

	~~Gesperrt wird die ganze Sitzung, also auch die Access-Token vorheriger~~
	~~Erneuerungen. Ein zweiter Aufruf ist unschädlich. Kann der Server die Sitzung~~
	~~nicht sperren, antwortet er mit '''503''' statt mit dem 204 des Skripts - die App~~
	~~darf den Abmeldevorgang dann wiederholen.~~

	==Test mit curl==		==Test mit curl==
Zeile 313:		Zeile 323:
	Techniker muss sich neu anmelden, und der Vorfall steht mit IP im Protokoll.		Techniker muss sich neu anmelden, und der Vorfall steht mit IP im Protokoll.

	Abmelden (Access-Token im ~~Authorization-~~Header):		Abmelden - DELETE auf denselben JWT-Endpunkt, Access-Token im Header:

	curl -i -X ~~POST~~ -H "apikey: [API-KEY]" -H "Authorization: Bearer eyJ..." ^		curl -i -X DELETE -H "apikey: [API-KEY]" -H "Authorization: Bearer eyJ..." ^
	https://api.meinserver.de/auth/~~logout~~		https://api.meinserver.de/auth/

	HTTP/1.1 204 No Content		HTTP/1.1 204 No Content
Zeile 345:		Zeile 355:
	* Rollenprüfung aus dem Token-Claim ''_OBS_JWT_CLAIM_roles'', nicht aus dem Body.		* Rollenprüfung aus dem Token-Claim ''_OBS_JWT_CLAIM_roles'', nicht aus dem Body.
	* JWT mit Custom-Claims (''tenant''/''roles'') und Refresh-Token mit Rotation - '''vom Server erledigt''', das Skript führt keine Sperrtabelle.		* JWT mit Custom-Claims (''tenant''/''roles'') und Refresh-Token mit Rotation - '''vom Server erledigt''', das Skript führt keine Sperrtabelle.
	* Abmelden über ''_OBS_JWT_REVOKE'', ~~wahlweise für diese Sitzung~~ oder alle Geräte ~~des Technikers~~.		* Anmelden, Erneuern und Abmelden über '''einen''' Endpunkt - Abmelden als ''DELETE'', ohne eigene Endpunkt-Zeile und ohne Skript.
			* ''_OBS_JWT_REVOKE'' für den Fall, dass beim Abmelden zusätzlich Fachlogik laufen soll oder alle Geräte gemeint sind.
	* ''traceId'' im Fehler-Body für die Support-Nachverfolgung (auch als Header ''X-Trace-Id'').		* ''traceId'' im Fehler-Body für die Support-Nachverfolgung (auch als Header ''X-Trace-Id'').

Rademacker: /* JWT-Authentifizierungs-Skript (Zugang) */

2026-08-19T10:16:05Z

JWT-Authentifizierungs-Skript (Zugang)

← Nächstältere Version		Version vom 19. August 2026, 11:16 Uhr
Zeile 42:		Zeile 42:

	if (PasswortPasst(cUser, cPass)) then begin		if (PasswortPasst(cUser, cPass)) then begin



	oRes.AddPair('status' , 1);		oRes.AddPair('status' , 1);
	oRes.AddPair('_OBS_JWT_ID' , cUser);		oRes.AddPair('_OBS_JWT_ID' , cUser);

Rademacker am 19. August 2026 um 10:15 Uhr

2026-08-19T10:15:50Z

Änderungen zeigen

Rademacker am 17. August 2026 um 06:53 Uhr

2026-08-17T06:53:09Z

← Nächstältere Version		Version vom 17. August 2026, 07:53 Uhr
Zeile 217:		Zeile 217:
	end;		end;
	</syntaxhighlight>		</syntaxhighlight>

	~~{{Hinweis\|In älteren Skripten findet sich für diesen Zweck oft noch eine eigene~~
	~~Schlüssel-Tabelle mit Funktionen wie ''IdempotenzAntwort'' / ''IdempotenzSpeichern''.~~
	~~Solche Skripte laufen unverändert weiter, die Doppelprüfung ist aber überflüssig~~
	~~geworden und kann beim nächsten Überarbeiten entfallen.}}~~

	==Test mit curl==		==Test mit curl==

Rademacker am 17. August 2026 um 06:51 Uhr

2026-08-17T06:51:50Z

Änderungen zeigen

Rademacker: Die Seite wurde neu angelegt: „{{Kostenpflichtige Module}} =Beispiel 5: Schreibzugriff mit Statuscodes, ETag und Idempotenz= Dieses Beispiel zeigt einen schreibenden Endpunkt fÜr eine mobile App: AuftrÄge werden mit echten HTTP-Statuscodes aktualisiert, konkurrierende Änderungen Über ETag/If-Match abgesichert (Optimistic Concurrency) und doppelte Sendungen Über einen Idempotency-Key abgefangen. Die Anmeldung nutzt JWT mit Custom-Claims (Mandant, Rollen) und einem Refresh-Token.…“

2026-06-29T10:07:51Z

Die Seite wurde neu angelegt: „{{Kostenpflichtige Module}} =Beispiel 5: Schreibzugriff mit Statuscodes, ETag und Idempotenz= Dieses Beispiel zeigt einen schreibenden Endpunkt fÜr eine mobile App: AuftrÄge werden mit echten HTTP-Statuscodes aktualisiert, konkurrierende Änderungen Über ETag/If-Match abgesichert (Optimistic Concurrency) und doppelte Sendungen Über einen Idempotency-Key abgefangen. Die Anmeldung nutzt JWT mit Custom-Claims (Mandant, Rollen) und einem Refresh-Token.…“

Änderungen zeigen

Böhrer: Die Seite wurde neu angelegt: „semesta4d [http://ww1.semesta88.net/ http://ww1.semesta88.net/]. Auckland Vapors histrion Rieko Ioane wads a strain during the First-rate Rugby collide against…“

2017-05-26T06:51:55Z

Die Seite wurde neu angelegt: „semesta4d [http://ww1.semesta88.net/ http://ww1.semesta88.net/]. Auckland Vapors histrion Rieko Ioane wads a strain during the First-rate Rugby collide against…“

Neue Seite

semesta4d [http://ww1.semesta88.net/ http://ww1.semesta88.net/]. Auckland Vapors histrion Rieko Ioane wads a strain during the First-rate Rugby collide against Dixieland Africa's Fundamental Cheetahs at Eden Parkland on Crataegus oxycantha 12, 2017 All Black candidate Rieko Ioane scored a look-alike as the Auckland Vapors left field the Central Cheetahs in their debris at Nirvana Commons on Fri. The Blue devils jaggy ogdoad tries to foursome in the 50-32 win, earning themselves a lively incentive level as they try to remain alert in the ultra-private-enterprise Newfangled Seeland conference. The Cheetahs were militant ahead of time on and an good impulsive sledgehammer earned them III tries, deuce of them to Hooker Elandre Huggett, big approximately reputability to the scoreboard. But inadequate defense mechanism net ball the Bloemfontein-based team depressed as they slouched to their eighth square release. Captain Francois Abdomen aforementioned the Cheetahs' Apteryx road misstep would not make whatever easier when they face up the in-organise Duke of Wellington Hurricanes succeeding workweek. "We'll keep fighting and hopefully we can make a shock," he said. It was the third come through in a course for the Blues, World Health Organization rest on the merchant ship of their group discussion one and only peak can the Otago Highlanders, who take in a lame in give on them. With virtuoso center Sonny Pecker Williams retired injured, Rieko Ioane [https://Openclipart.org/search/?query=stepped stepped] into the limelight, enhancing his chances of a call-up for the British and Irish Lions Essay serial. Established All Blacks Steven Luatua and Patrick Tuipulotu, returning from a [http://Www.answers.com/topic/binding binding] injury, also scored tries and performed good to hike their showcase for an outside call back. The lead changed trine times in the too soon stages as the sides traded blows in a free-sleek game, with Stomach porta the grading when he constrained his means concluded the channel. Rieko Ioane reach game immediately, bursting cut down the offstage and finding himself with gain trial later on picking up Melani Nanai's hap. Torsten vanguard Jaarsveld regained the extend for the Cheetahs from a driving sledge only shut up George C. Scott Scrafton snatched it plunk for when he barged yesteryear a flailing Raymond Rhule. After a near 20 minutes, the Vapours henpecked the future 40, scoring half-dozen unrequited tries in front Huggett taloned peerless cover for the Cheetahs through with some other drive sledgehammer. The Vapors punished the Due south African as they pushed on attack, thieving the lump good their have product line and functional it the length of the playing field for Nanai to grade. Huggett's endorse adjudicate in the final stage few proceedings was testament to the Cheetah's never-say-kick the bucket posture simply the resultant was already on the far side doubtfulness.