HTTP Accept-Patch Header

Der HTTP-Header Accept-Patch ist ein Response-Header, mit dem der Server angibt, welche Medientypen er für PATCH-Requests auf eine Ressource akzeptiert. Der Header wird üblicherweise in Responses mit Status 405 (Method Not Allowed) oder in OPTIONS-Responses gesendet.

Typ

Response-Header

Syntax

Der Header listet die akzeptierten Patch-Formate kommagetrennt auf.

http 
Accept-Patch: application/json-patch+json
Accept-Patch: application/merge-patch+json, text/example

Direktiven

Die Direktiven definieren die unterstützten Patch-Dokumentformate.

application/json-patch+json
JSON Patch-Format nach RFC 6902 für strukturierte Änderungsoperationen (add, remove, replace).
application/merge-patch+json
JSON Merge Patch nach RFC 7386 für einfache Teilaktualisierungen durch Merge.
application/xml-patch+xml
XML-basiertes Patch-Format für XML-Ressourcen.
text/example
Beliebiger benutzerdefinierter Patch-Medientyp für spezielle Anwendungsfälle.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Accept-Patch-Header.

Beispiel 1 JSON Patch Support

http 
HTTP/1.1 200 OK
Accept-Patch: application/json-patch+json

Server unterstützt strukturierte JSON Patch-Operationen nach RFC 6902.

Beispiel 2 Mehrere Patch Formate

http 
HTTP/1.1 200 OK
Accept-Patch: application/json-patch+json, application/merge-patch+json

Server akzeptiert sowohl JSON Patch als auch Merge Patch für flexible Aktualisierungen.

Beispiel 3 Method Not Allowed Response

http 
HTTP/1.1 405 Method Not Allowed
Allow: GET, HEAD, OPTIONS, PATCH
Accept-Patch: application/json-patch+json

PATCH Operation Flow

PATCH Request Flow für partielle Ressourcen-Updates

Vorteile für die Systemarchitektur

  • Bandbreiteneffizienz: Nur geänderte Felder werden übertragen statt vollständiger Ressourcen
  • Atomare Operationen: Strukturierte Patches ermöglichen präzise und sichere Teilaktualisierungen
  • API-Klarheit: Explizite Deklaration unterstützter Patch-Formate verbessert Client-Server-Kommunikation

Spezifikation

RFC 5789 – PATCH Method for HTTP https://www.rfc-editor.org/rfc/rfc5789.html

Weitere Spezifikationen

PATCH Method, Content-Type Header, HTTP Status 405 - Method Not Allowed