OBS/Kostenpflichtige Module/RESTServer/Endpunkte - Versionsgeschichte

MINERVA-Rademacker: Idempotency-Key als Pflicht, Aufraeumen offener Reservierungen berichtigt, Fehlercodes 400/503/308 ergaenzt [Volltext ersetzt]

2026-09-25T09:28:32Z

Idempotency-Key als Pflicht, Aufraeumen offener Reservierungen berichtigt, Fehlercodes 400/503/308 ergaenzt [Volltext ersetzt]

← Nächstältere Version		Version vom 25. September 2026, 10:28 Uhr
Zeile 86:		Zeile 86:
	Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für		Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für
	Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.		Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.
	Der Originalname (beim resumable Upload über den Header <code>Upload-Metadata</code>) ist '''Pflicht'''; fehlt er, wird der Upload mit ~~413/~~400 abgelehnt. Das Skript liest Pfad, Name, Content-Type und die SHA-256-Prüfsumme der gespeicherten Datei über <code>oReader.UploadPath()</code>, <code>UploadName()</code>, <code>UploadType()</code> und <code>UploadSha()</code>; bei <code>multipart/form-data</code> die übrigen Formularfelder über <code>oReader.Form('<name>')</code>.		Der Originalname (beim resumable Upload über den Header <code>Upload-Metadata</code>) ist '''Pflicht'''; fehlt er, wird der Upload mit '''400''' abgelehnt, ohne dass eine Datei angelegt wird. Das Skript liest Pfad, Name, Content-Type und die SHA-256-Prüfsumme der gespeicherten Datei über <code>oReader.UploadPath()</code>, <code>UploadName()</code>, <code>UploadType()</code> und <code>UploadSha()</code>; bei <code>multipart/form-data</code> die übrigen Formularfelder über <code>oReader.Form('<name>')</code>.

	'''Das Übertragungsprotokoll''' - Header, Statuscodes, Resume-Verhalten - steht auf einer eigenen Seite: [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]].		'''Das Übertragungsprotokoll''' - Header, Statuscodes, Resume-Verhalten - steht auf einer eigenen Seite: [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]].
Zeile 195:		Zeile 195:
	\| '''429''' \|\| Rate-Limit überschritten; die Antwort enthält den Header <code>Retry-After</code>		\| '''429''' \|\| Rate-Limit überschritten; die Antwort enthält den Header <code>Retry-After</code>
	\|-		\|-
	\| '''503''' \|\| ~~Eine~~ Anfrage mit demselben <code>Idempotency-Key</code> wird gerade verarbeitet~~; die Antwort enthält~~ <code>Retry-After</code>		\| '''503''' \|\| Vier Ursachen, unterscheidbar am <code>code</code>: <code>IDEMPOTENCY_IN_PROGRESS</code> (eine Anfrage mit demselben <code>Idempotency-Key</code> wird gerade verarbeitet), <code>SERVICE_UNAVAILABLE</code> bei erreichter Andrangsgrenze des Server-Profils (<code>rsv_max_parallel</code>), bei einer Anmeldung, deren Sitzungszeile nicht geschrieben werden konnte, sowie bei einem fehlgeschlagenen <code>JwtRevoke</code>. Alle vier tragen <code>Retry-After</code>
	\|-		\|-
	\| '''409''' \|\| Ein früherer Aufruf mit demselben <code>Idempotency-Key</code> ist ohne Ergebnis geblieben (<code>IDEMPOTENCY_UNRESOLVED</code>)		\| '''409''' \|\| Ein früherer Aufruf mit demselben <code>Idempotency-Key</code> ist ohne Ergebnis geblieben (<code>IDEMPOTENCY_UNRESOLVED</code>)
Zeile 201:		Zeile 201:
	\| '''422''' \|\| Derselbe <code>Idempotency-Key</code> wurde mit '''anderem''' Inhalt gesendet (<code>IDEMPOTENCY_KEY_REUSED</code>)		\| '''422''' \|\| Derselbe <code>Idempotency-Key</code> wurde mit '''anderem''' Inhalt gesendet (<code>IDEMPOTENCY_KEY_REUSED</code>)
	\|-		\|-
	\| '''400''' \|\| ~~Die~~ Anfrage ~~wurde~~ unverschlüsselt an einen TLS-Port geschickt (<code>http</code> statt <code>https</code>)~~. Die Abweisung erfolgt~~ vor Authentifizierung und Endpunkt-Skript		\| '''400''' \|\| Ein schreibender Aufruf (POST/PUT/PATCH/DELETE) '''ohne''' <code>Idempotency-Key</code> (<code>IDEMPOTENCY_KEY_MISSING</code>); ein resumable Upload ohne Dateinamen; oder eine Anfrage, die unverschlüsselt an einen TLS-Port geschickt wurde (<code>http</code> statt <code>https</code>) - letztere wird vor Authentifizierung und Endpunkt-Skript abgewiesen
			\|-
			\| '''308''' \|\| Zwischenantwort beim resumable Upload: das Teilstück wurde angehängt, der Upload ist noch nicht vollständig. Die Antwort trägt <code>Upload-Id</code>, <code>Upload-Offset</code> und <code>Range</code>; das Skript läuft dabei '''nicht'''
	\|}		\|}

Zeile 212:		Zeile 214:
	== Idempotenz ==		== Idempotenz ==

	~~Schickt ein Konsument bei~~ <code>POST</code>, <code>PUT</code>, <code>PATCH</code>		Bei <code>POST</code>, <code>PUT</code>, <code>PATCH</code> und <code>DELETE</code>
	~~oder~~ <code>DELETE</code> ~~den Header <code>Idempotency-Key</code>,~~ sorgt der Server		sorgt der Server selbst dafür, dass eine wiederholte Sendung '''keine
	selbst dafür, dass eine wiederholte Sendung '''keine Zweitwirkung''' hat. Das gilt		Zweitwirkung''' hat. Das gilt für '''jeden''' Endpunkt - es muss weder am Endpunkt
	für '''jeden''' Endpunkt - es muss weder am Endpunkt etwas eingestellt noch im		etwas eingestellt noch im Skript etwas programmiert werden.
	Skript etwas programmiert werden.
			{{Achtung\|'''Der Header <code>Idempotency-Key</code> ist bei diesen vier Verben
			Pflicht.''' Fehlt er, antwortet der Server mit '''400'''
			<code>IDEMPOTENCY_KEY_MISSING</code> und das Endpunkt-Skript läuft '''nicht''' an.

			Bis v1.21 lief eine Anfrage ohne den Header ungeschützt durch; der Schutz gegen
			die Doppelbuchung lag damit beim Client. Ausgenommen ist allein der
			JWT-Endpunkt (Anmelden, Erneuern, Abmelden) - er greift vor der Adressauflösung
			und kennt die Mechanik nicht.}}

	{\| class="wikitable"		{\| class="wikitable"
	! Situation !! Antwort des Servers		! Situation !! Antwort des Servers
			\|-
			\| Kein <code>Idempotency-Key</code> gesendet \|\| '''400''' <code>IDEMPOTENCY_KEY_MISSING</code>. Das Skript läuft nicht
	\|-		\|-
	\| Erster Aufruf \|\| Endpunkt läuft normal, das Ergebnis wird zum Schlüssel gespeichert		\| Erster Aufruf \|\| Endpunkt läuft normal, das Ergebnis wird zum Schlüssel gespeichert
Zeile 235:		Zeile 247:

	* Antwortet das Skript mit '''2xx''', wird die Antwort gespeichert und bei einer Wiederholung erneut ausgeliefert.		* Antwortet das Skript mit '''2xx''', wird die Antwort gespeichert und bei einer Wiederholung erneut ausgeliefert.
			* '''Ausnahme Dateiantwort:''' Liefert das Skript mit <code>SendFile</code>/<code>SendTempFile</code> eine '''Datei''' aus, wird '''nichts''' festgeschrieben - eine Dateiantwort liesse sich nicht wiedergeben, gespeichert würde eine leere 200er-Antwort. Der Schlüssel wird stattdessen wieder freigegeben, ein erneuter Abruf derselben Datei ist unschädlich.
	* Antwortet das Skript mit '''4xx''' (fachliche Ablehnung), wird der Schlüssel wieder '''freigegeben''' - der Konsument darf ihn nach Korrektur erneut verwenden. Sonst würde ein einziger Validierungsfehler den Schlüssel dauerhaft blockieren.		* Antwortet das Skript mit '''4xx''' (fachliche Ablehnung), wird der Schlüssel wieder '''freigegeben''' - der Konsument darf ihn nach Korrektur erneut verwenden. Sonst würde ein einziger Validierungsfehler den Schlüssel dauerhaft blockieren.
	* Endet die Verarbeitung mit '''5xx''' oder einem Skript-Fehler, wird der Schlüssel '''freigegeben''' und der Fall protokolliert. Der Konsument darf denselben Schlüssel erneut senden.		* Endet die Verarbeitung mit '''5xx''' oder einem Skript-Fehler, wird der Schlüssel '''freigegeben''' und der Fall protokolliert. Der Konsument darf denselben Schlüssel erneut senden.
Zeile 245:		Zeile 258:
	'''stabil wiederverwenden''' (also nicht bei jedem Wiederholversuch neu erzeugen).		'''stabil wiederverwenden''' (also nicht bei jedem Wiederholversuch neu erzeugen).

	Die Einträge stehen in <code>RESTSRV_IDEMPOTENCY</code> ~~und~~ werden nach 30 Tagen		Die Einträge stehen in <code>RESTSRV_IDEMPOTENCY</code>. Abgeschlossene Einträge
	~~automatisch aufgeräumt~~. Einträge ohne Ergebnis werden '''~~nicht~~''' ~~automatisch~~		werden nach '''30 Tagen''' gelöscht. Einträge '''ohne Ergebnis''' - sie entstehen
	gelöscht, sondern ~~im Protokoll gemeldet~~.		nur bei einem harten Abbruch des Dienstes - werden ab '''24 Stunden''' im Protokoll
			gemeldet und '''anschliessend ebenfalls gelöscht'''. Das Stehenlassen wäre keine
			Vorsicht, sondern eine Sperre: derselbe Vorgang mit demselben Schlüssel wäre sonst
			nie wieder durchführbar.

	== WebHooks ==		== WebHooks ==

Rademacker am 15. September 2026 um 10:00 Uhr

2026-09-15T10:00:38Z

← Nächstältere Version		Version vom 15. September 2026, 11:00 Uhr
Zeile 189:		Zeile 189:
	\| '''416''' \|\| Der angefragte <code>Range</code> liegt hinter dem Dateiende; die Antwort nennt in <code>Content-Range</code> die wirkliche Grösse		\| '''416''' \|\| Der angefragte <code>Range</code> liegt hinter dem Dateiende; die Antwort nennt in <code>Content-Range</code> die wirkliche Grösse
	\|-		\|-
	\| '''415''' \|\| Datei-Upload an einen Endpunkt, der dafür nicht freigeschaltet ist (<code>re_upload = 0</code>)		\| '''415''' \|\| Datei-Upload an einen Endpunkt, der dafür nicht freigeschaltet ist (<code>re_upload = 0</code>); oder ein <code>Content-Encoding</code>, das der Server nicht entpacken kann - unterstützt wird allein <code>gzip</code> (siehe [[OBS/Kostenpflichtige Module/RESTServer\|REST-Server]], Abschnitt Kompression)
	\|-		\|-
	\| '''413''' \|\| Hochgeladene Datei überschreitet die zulässige Maximalgrösse (<code>re_upload_size</code>)		\| '''413''' \|\| Hochgeladene Datei überschreitet die zulässige Maximalgrösse (<code>re_upload_size</code>); oder der Anfragekörper überschreitet 10 MB bzw. - gepackt gesendet - das 400fache der gesendeten Grösse
	\|-		\|-
	\| '''429''' \|\| Rate-Limit überschritten; die Antwort enthält den Header <code>Retry-After</code>		\| '''429''' \|\| Rate-Limit überschritten; die Antwort enthält den Header <code>Retry-After</code>

Rademacker am 14. September 2026 um 08:07 Uhr

2026-09-14T08:07:29Z

@@ Zeile 99: / Zeile 99: @@
 DMS-Verknüpfung, Weiterverarbeitung), entscheidet allein das Skript. Details und
 Beispiele: [[OBS/Kostenpflichtige Module/RESTServer/Scripting|Scripting]].
 == HTTP-Methode ==
@@ Zeile 172: / Zeile 184: @@
 |-
 | '''405''' || Das Endpunkt-Skript hat für die angefragte HTTP-Methode keine Funktion; der Header <code>Allow</code> nennt die vorhandenen
 |-
 | '''415''' || Datei-Upload an einen Endpunkt, der dafür nicht freigeschaltet ist (<code>re_upload = 0</code>)

Rademacker am 9. September 2026 um 12:30 Uhr

2026-09-09T12:30:50Z

← Nächstältere Version		Version vom 9. September 2026, 13:30 Uhr
Zeile 61:		Zeile 61:
	== Pfad-Parameter im Skript ==		== Pfad-Parameter im Skript ==

	Die aus den Platzhaltern erfassten Werte ~~stehen im~~ Endpunkt-Skript ~~als~~		Die aus den Platzhaltern erfassten Werte liest das Endpunkt-Skript über
	~~reservierte Parameter mit Präfix~~ <code>~~_OBS_PATH_~~</code> ~~zur Verfügung~~:		<code>oReader.Path</code>:

	<syntaxhighlight lang="pascal">		<syntaxhighlight lang="pascal">
	~~function~~ Get(~~oParams~~: ~~TStrings~~; ~~oBody~~: ~~TJSONObject~~)~~: string~~;		procedure Get(oReader: TxRestReader; oWriter: TxRestWriter);
	var cUid: string;		var cUid: string;
	begin		begin
	cUid := ~~oParams~~.~~Values[~~'~~_OBS_PATH_uid~~']; // aus /orders/{uid}		cUid := oReader.Path('uid'); // aus /orders/{uid}
	// ...		// ...
	end;		end;
	</syntaxhighlight>		</syntaxhighlight>

	~~Da der Präfix <code>_OBS_</code> für von außen gelieferte Header/Query-Parameter~~		Diese Werte stammen aus dem Routing und können nicht durch den Client
	~~gesperrt ist,~~ können ~~diese Werte~~ nicht durch den Client überschrieben werden.		überschrieben werden.

	== Datei-Uploads ==		== Datei-Uploads ==
Zeile 86:		Zeile 86:
	Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für		Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für
	Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.		Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.
	Der Originalname (beim resumable Upload über den Header <code>Upload-Metadata</code>) ist '''Pflicht'''; fehlt er, wird der Upload mit 413/400 abgelehnt. ~~Dem~~ Skript ~~stehen~~ Pfad, Name, Content-Type und die SHA-256-Prüfsumme der gespeicherten Datei ~~als~~ <code>_OBS_UPLOAD_</code>~~-Parameter zur Verfügung~~; bei <code>multipart/form-data</code> ~~zusätzlich~~ die übrigen Formularfelder ~~als~~ <code>_OBS_FORM_</code> ~~(Details~~: [[OBS/Kostenpflichtige Module/RESTServer/~~Scripting~~\|~~Scripting~~]]).		Der Originalname (beim resumable Upload über den Header <code>Upload-Metadata</code>) ist '''Pflicht'''; fehlt er, wird der Upload mit 413/400 abgelehnt. Das Skript liest Pfad, Name, Content-Type und die SHA-256-Prüfsumme der gespeicherten Datei über <code>oReader.UploadPath()</code>, <code>UploadName()</code>, <code>UploadType()</code> und <code>UploadSha()</code>; bei <code>multipart/form-data</code> die übrigen Formularfelder über <code>oReader.Form('<name>')</code>.

			'''Das Übertragungsprotokoll''' - Header, Statuscodes, Resume-Verhalten - steht auf einer eigenen Seite: [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]].

	Unterstützt werden zwei Übertragungsarten:		Unterstützt werden zwei Übertragungsarten:
Zeile 132:		Zeile 134:
	Endpunkte sind Server-Profilen zugeordnet; ein Zugang benötigt eine explizite		Endpunkte sind Server-Profilen zugeordnet; ein Zugang benötigt eine explizite
	Berechtigung (Tabelle <code>RESTSRV_ACCESS</code>), um einen Endpunkt nutzen zu		Berechtigung (Tabelle <code>RESTSRV_ACCESS</code>), um einen Endpunkt nutzen zu
	dürfen. Weil jede Pfad-Form ein eigener Endpunkt-Eintrag ist, lässt sich der		dürfen.

			{{Achtung\|'''Ein Endpunkt besteht aus zwei Zeilen, und beide werden von Hand
			gepflegt:''' der Eintrag in <code>RESTSRV_ENDPOINTS</code> und die Berechtigung
			in <code>RESTSRV_ACCESS</code>. Fehlt die zweite, antwortet der Endpunkt
			'''403''' - und sieht dabei fertig aus: Pfad, Skript und Server-Profil stehen
			korrekt da, der Aufruf kommt trotzdem nicht durch. Das ist die häufigste Ursache
			für ein „der Endpunkt ist doch angelegt" und kostet jedes Mal eine
			Fehlersuche, weil der Statuscode nach einem Rechteproblem des Konsumenten
			aussieht und nicht nach einer fehlenden Konfigurationszeile.

			Beim Anlegen also '''immer beide Zeilen''', und beim Prüfen eines
			<code>403</code> zuerst nachsehen, ob die zweite existiert.}} Weil jede Pfad-Form ein eigener Endpunkt-Eintrag ist, lässt sich der
	Zugriff '''pro Pfad-Form''' granular vergeben (z. B. Lesen von		Zugriff '''pro Pfad-Form''' granular vergeben (z. B. Lesen von
	<code>/orders/{uid}</code> erlauben, aber das ändernde		<code>/orders/{uid}</code> erlauben, aber das ändernde

Rademacker am 31. August 2026 um 05:03 Uhr

2026-08-31T05:03:04Z

Rademacker am 19. August 2026 um 10:15 Uhr

2026-08-19T10:15:05Z

← Nächstältere Version		Version vom 19. August 2026, 11:15 Uhr
Zeile 153:		Zeile 153:
	\| '''403''' \|\| Zugang fehlt in der Berechtigungsliste		\| '''403''' \|\| Zugang fehlt in der Berechtigungsliste
	\|-		\|-
	\| '''401''' \|\| API-Key ungültig/fehlend ~~oder~~ JWT abgelaufen		\| '''401''' \|\| API-Key ungültig/fehlend, JWT abgelaufen oder Sitzung gesperrt (''AUTH_EXPIRED'')
	\|-		\|-
	\| '''500''' \|\| Skript- oder Syntax-Fehler (Details in <code>RESTSRV_PROTO</code>)		\| '''500''' \|\| Skript- oder Syntax-Fehler (Details in <code>RESTSRV_PROTO</code>)

Rademacker am 18. August 2026 um 06:03 Uhr

2026-08-18T06:03:14Z

← Nächstältere Version		Version vom 18. August 2026, 07:03 Uhr
Zeile 168:		Zeile 168:
	\|-		\|-
	\| '''422''' \|\| Derselbe <code>Idempotency-Key</code> wurde mit '''anderem''' Inhalt gesendet (<code>IDEMPOTENCY_KEY_REUSED</code>)		\| '''422''' \|\| Derselbe <code>Idempotency-Key</code> wurde mit '''anderem''' Inhalt gesendet (<code>IDEMPOTENCY_KEY_REUSED</code>)
			\|-
			\| '''400''' \|\| Die Anfrage wurde unverschlüsselt an einen TLS-Port geschickt (<code>http</code> statt <code>https</code>). Die Abweisung erfolgt vor Authentifizierung und Endpunkt-Skript
	\|}		\|}

	Jede Fehlerantwort ~~enthält zusätzlich ein~~ <code>error</code>-Objekt mit		Jede Fehlerantwort besteht aus einem <code>error</code>-Objekt mit
	maschinenlesbarem Code - Aufbau siehe		maschinenlesbarem Code - Aufbau siehe
	[[OBS/Kostenpflichtige Module/RESTServer\|Übersicht]].		[[OBS/Kostenpflichtige Module/RESTServer\|Übersicht]].

Rademacker am 17. August 2026 um 06:50 Uhr

2026-08-17T06:50:16Z

@@ Zeile 161: / Zeile 161: @@
 | '''413''' || Hochgeladene Datei überschreitet die zulässige Maximalgrösse (<code>re_upload_size</code>)
 |-
-| '''429''' || Rate-Limit Überschritten; die Antwort enthÄlt den Header <code>Retry-After</code>
+| '''429''' || Rate-Limit überschritten; die Antwort enthält den Header <code>Retry-After</code>
 |}
 Daneben kann ein Endpunkt-Skript den Statuscode selbst setzen (z.B. <code>201</code>, <code>204</code>, <code>409</code>, <code>422</code>) sowie Response-Header wie <code>ETag</code> oder <code>Location</code> - siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting|Scripting]].
 == WebHooks ==
@@ Zeile 171: / Zeile 218: @@
 erfolgreichen Aufruf wird die Antwort in der Tabelle <code>REMOTE_HOOK_URL</code>
 gespeichert und der Endpunkt anschließend automatisch gelöscht.

Rademacker am 30. Juni 2026 um 11:29 Uhr

2026-06-30T11:29:26Z

← Nächstältere Version		Version vom 30. Juni 2026, 12:29 Uhr
Zeile 86:		Zeile 86:
	Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für		Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für
	Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.		Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.
			Der Originalname (beim resumable Upload über den Header <code>Upload-Metadata</code>) ist '''Pflicht'''; fehlt er, wird der Upload mit 413/400 abgelehnt. Dem Skript stehen Pfad, Name und Content-Type als <code>_OBS_UPLOAD_*</code>-Parameter zur Verfügung (Details: [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).

	Unterstützt werden zwei Übertragungsarten:		Unterstützt werden zwei Übertragungsarten:

Rademacker am 30. Juni 2026 um 10:51 Uhr

2026-06-30T10:51:21Z

@@ Zeile 53: / Zeile 53: @@
 |-
 | '''Info''' || – || Dokumentations-Freitext
 |}
@@ Zeile 71: / Zeile 75: @@
 Da der Präfix <code>_OBS_</code> für von außen gelieferte Header/Query-Parameter
 gesperrt ist, können diese Werte nicht durch den Client überschrieben werden.
 == HTTP-Methode ==
@@ Zeile 130: / Zeile 155: @@
 |-
 | '''500''' || Skript- oder Syntax-Fehler (Details in <code>RESTSRV_PROTO</code>)
 |-
 | '''429''' || Rate-Limit Überschritten; die Antwort enthÄlt den Header <code>Retry-After</code>

← Nächstältere Version		Version vom 31. August 2026, 06:03 Uhr
Zeile 86:		Zeile 86:
	Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für		Limit überschritten, antwortet der Server mit '''413 Payload Too Large'''. Für
	Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.		Uploads gilt nicht das JSON-Body-Limit (10 MB), sondern dieses Endpunkt-Limit.
	Der Originalname (beim resumable Upload über den Header <code>Upload-Metadata</code>) ist '''Pflicht'''; fehlt er, wird der Upload mit 413/400 abgelehnt. Dem Skript stehen Pfad, Name ~~und~~ Content-Type als <code>_OBS_UPLOAD_*</code>-Parameter zur Verfügung (Details: [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).		Der Originalname (beim resumable Upload über den Header <code>Upload-Metadata</code>) ist '''Pflicht'''; fehlt er, wird der Upload mit 413/400 abgelehnt. Dem Skript stehen Pfad, Name, Content-Type und die SHA-256-Prüfsumme der gespeicherten Datei als <code>_OBS_UPLOAD_</code>-Parameter zur Verfügung; bei <code>multipart/form-data</code> zusätzlich die übrigen Formularfelder als <code>_OBS_FORM_</code> (Details: [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]]).

	Unterstützt werden zwei Übertragungsarten:		Unterstützt werden zwei Übertragungsarten:
Zeile 156:		Zeile 156:
	\|-		\|-
	\| '''500''' \|\| Skript- oder Syntax-Fehler (Details in <code>RESTSRV_PROTO</code>)		\| '''500''' \|\| Skript- oder Syntax-Fehler (Details in <code>RESTSRV_PROTO</code>)
			\|-
			\| '''405''' \|\| Das Endpunkt-Skript hat für die angefragte HTTP-Methode keine Funktion; der Header <code>Allow</code> nennt die vorhandenen
	\|-		\|-
	\| '''415''' \|\| Datei-Upload an einen Endpunkt, der dafür nicht freigeschaltet ist (<code>re_upload = 0</code>)		\| '''415''' \|\| Datei-Upload an einen Endpunkt, der dafür nicht freigeschaltet ist (<code>re_upload = 0</code>)
Zeile 197:		Zeile 199:
	\| Erster Aufruf läuft noch \|\| '''503''' <code>IDEMPOTENCY_IN_PROGRESS</code> mit <code>Retry-After</code>. Beim nächsten Versuch liegt die gespeicherte Antwort vor		\| Erster Aufruf läuft noch \|\| '''503''' <code>IDEMPOTENCY_IN_PROGRESS</code> mit <code>Retry-After</code>. Beim nächsten Versuch liegt die gespeicherte Antwort vor
	\|-		\|-
	\| Früherer Aufruf ohne Ergebnis \|\| '''409''' <code>IDEMPOTENCY_UNRESOLVED</code>. ~~Der Dienst wurde~~ zwischen Verarbeitung und Festschreiben ~~unterbrochen~~; ob die Buchung stattgefunden hat, ist unbekannt und ~~von Hand zu klären~~		\| Früherer Aufruf ohne Ergebnis \|\| '''409''' <code>IDEMPOTENCY_UNRESOLVED</code>. Nur noch nach einem '''harten Abbruch''' des Dienstes zwischen Verarbeitung und Festschreiben; ob die Buchung stattgefunden hat, ist unbekannt. Der Aufräumlauf gibt solche Einträge nach 24 Stunden frei und protokolliert sie
	\|}		\|}

Zeile 204:		Zeile 206:
	* Antwortet das Skript mit '''2xx''', wird die Antwort gespeichert und bei einer Wiederholung erneut ausgeliefert.		* Antwortet das Skript mit '''2xx''', wird die Antwort gespeichert und bei einer Wiederholung erneut ausgeliefert.
	* Antwortet das Skript mit '''4xx''' (fachliche Ablehnung), wird der Schlüssel wieder '''freigegeben''' - der Konsument darf ihn nach Korrektur erneut verwenden. Sonst würde ein einziger Validierungsfehler den Schlüssel dauerhaft blockieren.		* Antwortet das Skript mit '''4xx''' (fachliche Ablehnung), wird der Schlüssel wieder '''freigegeben''' - der Konsument darf ihn nach Korrektur erneut verwenden. Sonst würde ein einziger Validierungsfehler den Schlüssel dauerhaft blockieren.
	* Endet die Verarbeitung mit '''5xx''' oder einem Skript-Fehler, ~~bleibt~~ der Schlüssel ~~belegt~~ und der Fall ~~wird~~ protokolliert. Das ist ~~Absicht~~: ~~lieber~~ ein ~~Fall~~ für ~~den Support als eine mögliche Doppelbuchung~~.		* Endet die Verarbeitung mit '''5xx''' oder einem Skript-Fehler, wird der Schlüssel '''freigegeben''' und der Fall protokolliert. Der Konsument darf denselben Schlüssel erneut senden.
			* Das ist eine bewusste Abwägung (geändert 2026-08-25): Bleibt der Schlüssel nach einem Serverfehler belegt, ist der Vorgang '''unwiederholbar''' - der Client bekommt dauerhaft 503 und müsste die erfasste Arbeit verwerfen. Garantierter Datenverlust wiegt schwerer als ein möglicher Doppelsatz.
			* '''Folge für die Auslegung:''' ein schreibender Endpunkt sollte selbst wiederholbar sein, etwa über ein fachliches Merkmal des Clients. Wo reines Anhängen stattfindet (Positionen, Dateien), bleibt sonst ein Restrisiko.

	Der Schlüssel gilt je '''Zugang, Methode und Pfad'''. Derselbe		Der Schlüssel gilt je '''Zugang, Methode und Pfad'''. Derselbe