OBS/Kostenpflichtige Module/RESTServer/Einrichtung - Versionsgeschichte

MINERVA-Rademacker: Automatische Zertifikatserneuerung als Alternative ergaenzt; Angaben zu Root-Zertifikat und Feldbezeichnungen richtiggestellt [Volltext ersetzt]

2026-10-05T06:34:37Z

Automatische Zertifikatserneuerung als Alternative ergaenzt; Angaben zu Root-Zertifikat und Feldbezeichnungen richtiggestellt [Volltext ersetzt]

← Nächstältere Version		Version vom 5. Oktober 2026, 07:34 Uhr
Zeile 9:		Zeile 9:
	# OBS-Support kontaktieren und das REST-Server-Modul aktivieren lassen.		# OBS-Support kontaktieren und das REST-Server-Modul aktivieren lassen.
	# Prüfen, ob auf dem Zielrechner (OBS-Server oder dedizierter REST-Server) Port und IP-Adresse frei sind.		# Prüfen, ob auf dem Zielrechner (OBS-Server oder dedizierter REST-Server) Port und IP-Adresse frei sind.
	# Bei TLS-Profilen: TLS-Zertifikat (PEM, ~~ggf.~~ mit ~~Chain~~), privaten Schlüssel (PEM) und - falls mTLS - das CA-Root-Zertifikat bereithalten.		# Bei TLS-Profilen: TLS-Zertifikat (PEM, mit Kette), privaten Schlüssel (PEM) und - falls mTLS - das CA-Root-Zertifikat bereithalten. Alternativ nutzen Sie die automatische Zertifikatserneuerung; dann genügen ein öffentlicher Name und eine Weiterleitung von Port 80 auf diesen Server.

	==Schritt 1: Server-Profil anlegen==		==Schritt 1: Server-Profil anlegen==
Zeile 18:		Zeile 18:
	* '''Name''' - sprechender Name (z.B. ''Public-API'', ''Internal-mTLS'', ''Debug-Local'').		* '''Name''' - sprechender Name (z.B. ''Public-API'', ''Internal-mTLS'', ''Debug-Local'').
	* Auswahl des Modus:		* Auswahl des Modus:
	** '''Standard-TLS''' (Default): Zertifikat ~~+ Key + Root~~-~~Zertifikat hinterlegen~~.		** '''Standard-TLS''' (Default): Zertifikat und Schlüssel hinterlegen - oder auf der Registerkarte '''4 Zertifikaterneuerung''' die automatische Erneuerung aktivieren.
	** '''mTLS''' ~~aktivieren~~: zusätzlich CA-Root-Zertifikat hinterlegen, ~~jeder~~ Client muss ein gültiges ~~Cert~~ vorlegen.		** '''mTLS-Modus aktiv''' setzen: zusätzlich das CA-Root-Zertifikat hinterlegen, gegen das die Client-Zertifikate geprüft werden. Jeder Client muss dann ein gültiges Zertifikat vorlegen.
	** '''~~Kein~~ SSL''' ~~aktivieren~~: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.		** '''kein SSL''' setzen: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.

	Optional lassen sich am Profil eigene '''Rate-Limit-Schwellen''' hinterlegen. Ohne		Optional lassen sich am Profil eigene '''Rate-Limit-Schwellen''' hinterlegen. Ohne

MINERVA-Rademacker: Wartung der Idempotenz-Tabelle berichtigt, Stolperstein fehlender Idempotency-Key ergaenzt [Volltext ersetzt]

2026-09-25T09:28:33Z

Wartung der Idempotenz-Tabelle berichtigt, Stolperstein fehlender Idempotency-Key ergaenzt [Volltext ersetzt]

Schinke: /* Schritt 2: Bindung anlegen */

2026-09-10T11:14:45Z

Schritt 2: Bindung anlegen

← Nächstältere Version		Version vom 10. September 2026, 12:14 Uhr
Zeile 35:		Zeile 35:

	* '''Host''' - IP-Adresse, auf der gelauscht werden soll (z.B. ''0.0.0.0'' für alle Adressen, ''127.0.0.1'' für lokal).		* '''Host''' - IP-Adresse, auf der gelauscht werden soll (z.B. ''0.0.0.0'' für alle Adressen, ''127.0.0.1'' für lokal).
	* '''Port''' - Port-Nummer (typisch 443 für HTTPS, 8099 für Debug, ggf. abweichend).		* '''Port''' - Port-Nummer (typisch 443 für HTTPS, 8099 für Debug, ggf. abweichend). {{Achtung\|Port 8080 wird für RustDesk verwendet und darf daher nicht verwendet werden}}
	* '''Standard''' setzen, wenn diese Bindung die Standard-Bindung des Servers ist (pro Server-Profil nur eine).		* '''Standard''' setzen, wenn diese Bindung die Standard-Bindung des Servers ist (pro Server-Profil nur eine).

Rademacker am 9. September 2026 um 12:30 Uhr

2026-09-09T12:30:27Z

← Nächstältere Version		Version vom 9. September 2026, 13:30 Uhr
Zeile 60:		Zeile 60:
	* '''Datei-Upload''' - nur setzen, wenn der Endpunkt Dateien entgegennehmen soll; dann auch die '''Max. Upload-Grösse''' in MB festlegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Beispiel6\|Beispiel 6]]).		* '''Datei-Upload''' - nur setzen, wenn der Endpunkt Dateien entgegennehmen soll; dann auch die '''Max. Upload-Grösse''' in MB festlegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Beispiel6\|Beispiel 6]]).

	{{Hinweis\|~~Die früheren Felder '''Sub-URL''' und '''Version''' werden nicht mehr ausgewertet.~~ Eine Versionskennung wird ~~ggf.~~ als statisches Segment ins Pfad-Template aufgenommen (z.B. ''/orders/v1''). Details: [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]].}}		{{Hinweis\|Eine Versionskennung wird als statisches Segment ins Pfad-Template aufgenommen (z.B. ''/orders/v1''); ein eigenes Versionsfeld gibt es nicht. Details: [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]].}}

	Anschliessend mit '''F7''' das Endpunkt-Skript pflegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).		Anschliessend mit '''F7''' das Endpunkt-Skript pflegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).

Rademacker am 31. August 2026 um 05:04 Uhr

2026-08-31T05:04:01Z

← Nächstältere Version		Version vom 31. August 2026, 06:04 Uhr
Zeile 108:		Zeile 108:
	* Skript geändert, aber der Aufruf verhält sich noch wie vorher -> Endpunkt-Cache abwarten (bis zu 60 Sekunden).		* Skript geändert, aber der Aufruf verhält sich noch wie vorher -> Endpunkt-Cache abwarten (bis zu 60 Sekunden).
	* Wiederholter Schreibaufruf liefert 422 ''IDEMPOTENCY_KEY_REUSED'' -> der Client sendet denselben ''Idempotency-Key'' mit geändertem Inhalt. Pro Vorgang genau ein Schlüssel, über alle Wiederholversuche hinweg unverändert.		* Wiederholter Schreibaufruf liefert 422 ''IDEMPOTENCY_KEY_REUSED'' -> der Client sendet denselben ''Idempotency-Key'' mit geändertem Inhalt. Pro Vorgang genau ein Schlüssel, über alle Wiederholversuche hinweg unverändert.
	* Wiederholter Schreibaufruf liefert 409 ''IDEMPOTENCY_UNRESOLVED'' -> ein früherer Versuch wurde ~~unterbrochen~~. Ob gebucht wurde, ist offen: im Protokoll und in den Fachdaten prüfen~~, dann~~ den Eintrag in '''RESTSRV_IDEMPOTENCY''' ~~entfernen~~.		* Wiederholter Schreibaufruf liefert 409 ''IDEMPOTENCY_UNRESOLVED'' -> ein früherer Versuch wurde hart abgebrochen (Dienst beendet). Ob gebucht wurde, ist offen: im Protokoll und in den Fachdaten prüfen. Der Aufräumlauf gibt den Eintrag nach 24 Stunden von selbst frei; wer schneller weitermachen will, entfernt ihn in '''RESTSRV_IDEMPOTENCY'''.
	* Nach einem Update antworten '''alle''' bestehenden Token mit 401 ''AUTH_EXPIRED'' -> erwartetes Verhalten. Token, die vor der Einführung der Sitzungsprüfung ausgestellt wurden, gehören zu keiner Sitzung; die Konsumenten müssen sich einmalig neu anmelden.		* Nach einem Update antworten '''alle''' bestehenden Token mit 401 ''AUTH_EXPIRED'' -> erwartetes Verhalten. Token, die vor der Einführung der Sitzungsprüfung ausgestellt wurden, gehören zu keiner Sitzung; die Konsumenten müssen sich einmalig neu anmelden.
	* Anmeldung liefert 503 statt eines Tokens -> die Sitzungszeile konnte nicht geschrieben werden. Ursache im Protokoll unter ''TokenStore: ...'' nachsehen; typisch ist eine fehlende Tabelle '''RESTSRV_TOKEN''' nach einem Update ohne Datenbank-Abgleich.		* Anmeldung liefert 503 statt eines Tokens -> die Sitzungszeile konnte nicht geschrieben werden. Ursache im Protokoll unter ''TokenStore: ...'' nachsehen; typisch ist eine fehlende Tabelle '''RESTSRV_TOKEN''' nach einem Update ohne Datenbank-Abgleich.
	* Abmelden liefert 503 -> die Sitzung liess sich nicht sperren. Der Client ist '''nicht''' abgemeldet und muss den Aufruf wiederholen; Details im Protokoll.		* Abmelden liefert 503 -> die Sitzung liess sich nicht sperren. Der Client ist '''nicht''' abgemeldet und muss den Aufruf wiederholen; Details im Protokoll.
	* Techniker wird beim Arbeiten unerwartet abgemeldet -> im Protokoll nach ''WIEDERVORLAGE'' suchen. Ein doppelt verwendetes Refresh-Token sperrt die Sitzung. Legt die App Token mehrfach parallel ab, gehört das clientseitig behoben.		* Techniker wird beim Arbeiten unerwartet abgemeldet -> im Protokoll nach ''WIEDERVORLAGE'' suchen. Ein doppelt verwendetes Refresh-Token sperrt die Sitzung. Legt die App Token mehrfach parallel ab, gehört das clientseitig behoben.

Rademacker am 19. August 2026 um 10:15 Uhr

2026-08-19T10:15:30Z

@@ Zeile 81: / Zeile 81: @@
 * In der Zugänge-Liste '''F8''' für die Statistik des Zugangs.
 * In '''Stammdaten -> Z Weitere Stammdaten -> REST-Server -> Protokoll''' die Ereignisse prüfen.
 ==Häufige Stolpersteine==
@@ Zeile 94: / Zeile 109: @@
 * Wiederholter Schreibaufruf liefert 422 ''IDEMPOTENCY_KEY_REUSED'' -> der Client sendet denselben ''Idempotency-Key'' mit geändertem Inhalt. Pro Vorgang genau ein Schlüssel, über alle Wiederholversuche hinweg unverändert.
 * Wiederholter Schreibaufruf liefert 409 ''IDEMPOTENCY_UNRESOLVED'' -> ein früherer Versuch wurde unterbrochen. Ob gebucht wurde, ist offen: im Protokoll und in den Fachdaten prüfen, dann den Eintrag in '''RESTSRV_IDEMPOTENCY''' entfernen.

Rademacker am 17. August 2026 um 06:53 Uhr

2026-08-17T06:53:56Z

← Nächstältere Version		Version vom 17. August 2026, 07:53 Uhr
Zeile 21:		Zeile 21:
	** '''mTLS''' aktivieren: zusätzlich CA-Root-Zertifikat hinterlegen, jeder Client muss ein gültiges Cert vorlegen.		** '''mTLS''' aktivieren: zusätzlich CA-Root-Zertifikat hinterlegen, jeder Client muss ein gültiges Cert vorlegen.
	** '''Kein SSL''' aktivieren: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.		** '''Kein SSL''' aktivieren: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.

			Optional lassen sich am Profil eigene '''Rate-Limit-Schwellen''' hinterlegen. Ohne
			Angabe gelten die Standardwerte (60-Sekunden-Fenster, 120 erfolgreiche und 10
			fehlgeschlagene Anfragen je Schlüssel, 600 Anfragen je Profil). Für Anwendungen
			ohne eigenen API-Key - typisch mobile Apps - sollten die Werte bewusst gesetzt
			werden, weil dann alle Benutzer hinter einer IP auf denselben Zähler laufen.

	Details siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile\|Server-Profile]].		Details siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile\|Server-Profile]].
Zeile 52:		Zeile 58:
	* '''Pfad-Template''' - der maßgebliche Routing-Pfad, ggf. mit Platzhaltern (z.B. ''/orders'', ''/orders/{uid}'', ''/orders/{uid}/modules/{code}'').		* '''Pfad-Template''' - der maßgebliche Routing-Pfad, ggf. mit Platzhaltern (z.B. ''/orders'', ''/orders/{uid}'', ''/orders/{uid}/modules/{code}'').
	* '''Server''' - die Server-Auswahl bestimmt, über welches Server-Profil der Endpunkt erreichbar ist.		* '''Server''' - die Server-Auswahl bestimmt, über welches Server-Profil der Endpunkt erreichbar ist.
			* '''Datei-Upload''' - nur setzen, wenn der Endpunkt Dateien entgegennehmen soll; dann auch die '''Max. Upload-Grösse''' in MB festlegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Beispiel6\|Beispiel 6]]).

	{{Hinweis\|Die früheren Felder '''Sub-URL''' und '''Version''' werden nicht mehr ausgewertet. Eine Versionskennung wird ggf. als statisches Segment ins Pfad-Template aufgenommen (z.B. ''/orders/v1''). Details: [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]].}}		{{Hinweis\|Die früheren Felder '''Sub-URL''' und '''Version''' werden nicht mehr ausgewertet. Eine Versionskennung wird ggf. als statisches Segment ins Pfad-Template aufgenommen (z.B. ''/orders/v1''). Details: [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]].}}
Zeile 83:		Zeile 90:
	* Falscher API-Key oder falscher Host beim Zugang -> Aufruf liefert 401 bzw. 403.		* Falscher API-Key oder falscher Host beim Zugang -> Aufruf liefert 401 bzw. 403.
	* mTLS aktiv, aber kein Client-Zertifikat installiert -> Verbindung wird während des TLS-Handshakes abgebrochen.		* mTLS aktiv, aber kein Client-Zertifikat installiert -> Verbindung wird während des TLS-Handshakes abgebrochen.
			* Datei-Upload ohne gesetzten Haken '''Datei-Upload''' am Endpunkt -> Aufruf liefert 415, das Skript läuft nicht an.
			* Skript geändert, aber der Aufruf verhält sich noch wie vorher -> Endpunkt-Cache abwarten (bis zu 60 Sekunden).
			* Wiederholter Schreibaufruf liefert 422 ''IDEMPOTENCY_KEY_REUSED'' -> der Client sendet denselben ''Idempotency-Key'' mit geändertem Inhalt. Pro Vorgang genau ein Schlüssel, über alle Wiederholversuche hinweg unverändert.
			* Wiederholter Schreibaufruf liefert 409 ''IDEMPOTENCY_UNRESOLVED'' -> ein früherer Versuch wurde unterbrochen. Ob gebucht wurde, ist offen: im Protokoll und in den Fachdaten prüfen, dann den Eintrag in '''RESTSRV_IDEMPOTENCY''' entfernen.

Rademacker am 15. Juni 2026 um 07:24 Uhr

2026-06-15T07:24:58Z

← Nächstältere Version		Version vom 15. Juni 2026, 08:24 Uhr
Zeile 49:		Zeile 49:
	Unter '''Endpunkte''' mit '''Einfg''' einen neuen Endpunkt anlegen:		Unter '''Endpunkte''' mit '''Einfg''' einen neuen Endpunkt anlegen:

	* '''Endpunkt''' - ~~der Hauptname~~ (z.B. ''~~kalender~~'', ''~~zeiterfa~~'').		* '''Endpunkt''' - Ressourcen-/Anzeigename (z.B. ''orders'', ''kalender''); dient nur der Übersicht, nicht dem Routing.
	* '''~~Sub~~-~~URL~~''' - ~~optional~~, z.B. ''~~mobile~~''.		* '''Pfad-Template''' - der maßgebliche Routing-Pfad, ggf. mit Platzhaltern (z.B. ''/orders'', ''/orders/{uid}'', ''/orders/{uid}/modules/{code}'').
	* '''~~Version~~''' ~~- z.B. ''v1~~''.
	* '''Server''' - die Server-Auswahl bestimmt, über welches Server-Profil der Endpunkt erreichbar ist.		* '''Server''' - die Server-Auswahl bestimmt, über welches Server-Profil der Endpunkt erreichbar ist.

			{{Hinweis\|Die früheren Felder '''Sub-URL''' und '''Version''' werden nicht mehr ausgewertet. Eine Versionskennung wird ggf. als statisches Segment ins Pfad-Template aufgenommen (z.B. ''/orders/v1''). Details: [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]].}}

	Anschliessend mit '''F7''' das Endpunkt-Skript pflegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).		Anschliessend mit '''F7''' das Endpunkt-Skript pflegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).
Zeile 64:		Zeile 65:
	Aufruf mit einem HTTP-Client (curl, Postman, Browser-Plug-in):		Aufruf mit einem HTTP-Client (curl, Postman, Browser-Plug-in):

	curl -H "apikey: [API-KEY]" https://api.meinserver.de/[~~Endpunkt]/[Version~~]		curl -H "apikey: [API-KEY]" https://api.meinserver.de/[Pfad-Template]

	Bei korrektem Setup erscheint die JSON-Antwort des Skripts. Fehlerfälle werden in '''RESTSRV_PROTO''' protokolliert.		Bei korrektem Setup erscheint die JSON-Antwort des Skripts. Fehlerfälle werden in '''RESTSRV_PROTO''' protokolliert.
Zeile 78:		Zeile 79:
	* Bindung angelegt, aber der Server wurde nicht neugestartet -> die Bindung ist noch nicht aktiv.		* Bindung angelegt, aber der Server wurde nicht neugestartet -> die Bindung ist noch nicht aktiv.
	* Endpunkt einem falschen Server zugeordnet -> Aufruf liefert 404 ''Endpunkt nicht vorhanden oder inaktiv''.		* Endpunkt einem falschen Server zugeordnet -> Aufruf liefert 404 ''Endpunkt nicht vorhanden oder inaktiv''.
			* Pfad-Template falsch geschrieben oder Segmentzahl passt nicht -> kein Template matcht, Aufruf liefert 404.
	* Zugang für den Endpunkt nicht freigeschaltet -> Aufruf liefert 403 ''Keine Berechtigung für die Endpunkt-Nutzung''.		* Zugang für den Endpunkt nicht freigeschaltet -> Aufruf liefert 403 ''Keine Berechtigung für die Endpunkt-Nutzung''.
	* Falscher API-Key oder falscher Host beim Zugang -> Aufruf liefert 401 bzw. 403.		* Falscher API-Key oder falscher Host beim Zugang -> Aufruf liefert 401 bzw. 403.
	* mTLS aktiv, aber kein Client-Zertifikat installiert -> Verbindung wird während des TLS-Handshakes abgebrochen.		* mTLS aktiv, aber kein Client-Zertifikat installiert -> Verbindung wird während des TLS-Handshakes abgebrochen.

Rademacker am 19. Mai 2026 um 07:13 Uhr

2026-05-19T07:13:52Z

← Nächstältere Version		Version vom 19. Mai 2026, 08:13 Uhr
Zeile 22:		Zeile 22:
	** '''Kein SSL''' aktivieren: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.		** '''Kein SSL''' aktivieren: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.

	Details siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-~~Profil~~\|Server-Profile]].		Details siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile\|Server-Profile]].

	==Schritt 2: Bindung anlegen==		==Schritt 2: Bindung anlegen==

Rademacker am 19. Mai 2026 um 07:13 Uhr

2026-05-19T07:13:43Z

← Nächstältere Version		Version vom 19. Mai 2026, 08:13 Uhr
Zeile 22:		Zeile 22:
	** '''Kein SSL''' aktivieren: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.		** '''Kein SSL''' aktivieren: ausschliesslich für lokale Tests, der Server akzeptiert dann nur Plain-HTTP.

	Details siehe [[OBS/Kostenpflichtige Module/RESTServer/Server\|Server-Profile]].		Details siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-Profil\|Server-Profile]].

	==Schritt 2: Bindung anlegen==		==Schritt 2: Bindung anlegen==

← Nächstältere Version		Version vom 9. September 2026, 13:30 Uhr
Zeile 60:		Zeile 60:
	* '''Datei-Upload''' - nur setzen, wenn der Endpunkt Dateien entgegennehmen soll; dann auch die '''Max. Upload-Grösse''' in MB festlegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Beispiel6\|Beispiel 6]]).		* '''Datei-Upload''' - nur setzen, wenn der Endpunkt Dateien entgegennehmen soll; dann auch die '''Max. Upload-Grösse''' in MB festlegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Beispiel6\|Beispiel 6]]).

	{{Hinweis\|~~Die früheren Felder '''Sub-URL''' und '''Version''' werden nicht mehr ausgewertet.~~ Eine Versionskennung wird ~~ggf.~~ als statisches Segment ins Pfad-Template aufgenommen (z.B. ''/orders/v1''). Details: [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]].}}		{{Hinweis\|Eine Versionskennung wird als statisches Segment ins Pfad-Template aufgenommen (z.B. ''/orders/v1''); ein eigenes Versionsfeld gibt es nicht. Details: [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]].}}

	Anschliessend mit '''F7''' das Endpunkt-Skript pflegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).		Anschliessend mit '''F7''' das Endpunkt-Skript pflegen (siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).

← Nächstältere Version		Version vom 25. September 2026, 10:28 Uhr
Zeile 90:		Zeile 90:
	! Tabelle !! Aufräumen		! Tabelle !! Aufräumen
	\|-		\|-
	\| RESTSRV_IDEMPOTENCY \|\| Abgeschlossene Einträge werden nach 30 Tagen gelöscht. Offene Reservierungen ~~bleiben absichtlich stehen und~~ werden ab 24 Stunden im Protokoll gemeldet - sie sind ein Support-Fall, siehe Stolpersteine		\| RESTSRV_IDEMPOTENCY \|\| Abgeschlossene Einträge werden nach 30 Tagen gelöscht. Offene Reservierungen werden ab 24 Stunden im Protokoll gemeldet und '''anschliessend ebenfalls gelöscht''' - sie sind trotzdem ein Support-Fall, weil die Fachwirkung unbekannt ist, siehe Stolpersteine
	\|-		\|-
	\| RESTSRV_TOKEN \|\| Zeilen werden gelöscht, sobald Access- '''und''' Refresh-Laufzeit vorbei sind. Läuft beim Serverstart und danach höchstens stündlich		\| RESTSRV_TOKEN \|\| Zeilen werden gelöscht, sobald Access- '''und''' Refresh-Laufzeit vorbei sind. Läuft beim Serverstart und danach höchstens stündlich
Zeile 107:		Zeile 107:
	* Datei-Upload ohne gesetzten Haken '''Datei-Upload''' am Endpunkt -> Aufruf liefert 415, das Skript läuft nicht an.		* Datei-Upload ohne gesetzten Haken '''Datei-Upload''' am Endpunkt -> Aufruf liefert 415, das Skript läuft nicht an.
	* Skript geändert, aber der Aufruf verhält sich noch wie vorher -> Endpunkt-Cache abwarten (bis zu 60 Sekunden).		* Skript geändert, aber der Aufruf verhält sich noch wie vorher -> Endpunkt-Cache abwarten (bis zu 60 Sekunden).
			* Schreibaufruf (POST/PUT/PATCH/DELETE) liefert 400 ''IDEMPOTENCY_KEY_MISSING'' -> der Client sendet keinen ''Idempotency-Key''. Der Header ist seit v1.21 '''Pflicht''', nicht optional; das Endpunkt-Skript läuft in diesem Fall gar nicht an. Betrifft typischerweise Konsumenten, die vor dem Update gebaut wurden.
	* Wiederholter Schreibaufruf liefert 422 ''IDEMPOTENCY_KEY_REUSED'' -> der Client sendet denselben ''Idempotency-Key'' mit geändertem Inhalt. Pro Vorgang genau ein Schlüssel, über alle Wiederholversuche hinweg unverändert.		* Wiederholter Schreibaufruf liefert 422 ''IDEMPOTENCY_KEY_REUSED'' -> der Client sendet denselben ''Idempotency-Key'' mit geändertem Inhalt. Pro Vorgang genau ein Schlüssel, über alle Wiederholversuche hinweg unverändert.
	* Wiederholter Schreibaufruf liefert 409 ''IDEMPOTENCY_UNRESOLVED'' -> ein früherer Versuch wurde hart abgebrochen (Dienst beendet). Ob gebucht wurde, ist offen: im Protokoll und in den Fachdaten prüfen. Der Aufräumlauf ~~gibt~~ den Eintrag nach 24 Stunden ~~von selbst frei~~; wer schneller weitermachen will, entfernt ihn in '''RESTSRV_IDEMPOTENCY'''.		* Wiederholter Schreibaufruf liefert 409 ''IDEMPOTENCY_UNRESOLVED'' -> ein früherer Versuch wurde hart abgebrochen (Dienst beendet). Ob gebucht wurde, ist offen: im Protokoll und in den Fachdaten prüfen. Der Aufräumlauf meldet den Eintrag nach 24 Stunden im Protokoll und löscht ihn dann; wer schneller weitermachen will, entfernt ihn in '''RESTSRV_IDEMPOTENCY'''.
	* Nach einem Update antworten '''alle''' bestehenden Token mit 401 ''AUTH_EXPIRED'' -> erwartetes Verhalten. Token, die vor der Einführung der Sitzungsprüfung ausgestellt wurden, gehören zu keiner Sitzung; die Konsumenten müssen sich einmalig neu anmelden.		* Nach einem Update antworten '''alle''' bestehenden Token mit 401 ''AUTH_EXPIRED'' -> erwartetes Verhalten. Token, die vor der Einführung der Sitzungsprüfung ausgestellt wurden, gehören zu keiner Sitzung; die Konsumenten müssen sich einmalig neu anmelden.
	* Anmeldung liefert 503 statt eines Tokens -> die Sitzungszeile konnte nicht geschrieben werden. Ursache im Protokoll unter ''TokenStore: ...'' nachsehen; typisch ist eine fehlende Tabelle '''RESTSRV_TOKEN''' nach einem Update ohne Datenbank-Abgleich.		* Anmeldung liefert 503 statt eines Tokens -> die Sitzungszeile konnte nicht geschrieben werden. Ursache im Protokoll unter ''TokenStore: ...'' nachsehen; typisch ist eine fehlende Tabelle '''RESTSRV_TOKEN''' nach einem Update ohne Datenbank-Abgleich.
	* Abmelden liefert 503 -> die Sitzung liess sich nicht sperren. Der Client ist '''nicht''' abgemeldet und muss den Aufruf wiederholen; Details im Protokoll.		* Abmelden liefert 503 -> die Sitzung liess sich nicht sperren. Der Client ist '''nicht''' abgemeldet und muss den Aufruf wiederholen; Details im Protokoll.
	* Techniker wird beim Arbeiten unerwartet abgemeldet -> im Protokoll nach ''WIEDERVORLAGE'' suchen. Ein doppelt verwendetes Refresh-Token sperrt die Sitzung. Legt die App Token mehrfach parallel ab, gehört das clientseitig behoben.		* Techniker wird beim Arbeiten unerwartet abgemeldet -> im Protokoll nach ''WIEDERVORLAGE'' suchen. Ein doppelt verwendetes Refresh-Token sperrt die Sitzung. Legt die App Token mehrfach parallel ab, gehört das clientseitig behoben.