HTTP 406 Not Acceptable

Der Server kann keine Repräsentation erzeugen, die Ihrem Accept-Header entspricht.

Definiert in RFC 9110 §15.5.7 — 406 Not Acceptable · MDN-Referenz

Wo Ihnen HTTP 406 in der Praxis begegnet

Eine Inhaltsverhandlung, die nicht erfolgreich abgeschlossen werden kann – etwa wenn ein Client von einem Endpunkt, der nur JSON unterstützt, Text/CSV anfordert oder eine Version im Accept-Header angegeben wird, die der Server nicht mehr unterstützt.

Warum Sie ihn testen sollten

Lohnt sich auszulösen, wenn Ihr Client einen engen Accept-Header sendet, denn der Fehler sieht aus wie ein Serverfehler und ist tatsächlich ein Aushandlungsfehler.

Was Ihr Client bei einem 406 tun sollte

Nicht mit demselben Accept-Header wiederholen. Weichen Sie auf einen Typ aus, den der Server anbietet, oder scheitern Sie mit einer Meldung, die nennt, was Sie angefragt haben. Ein 406, den ein Client in „Serverfehler“ verwandelt, kostet einen Bereitschaftsingenieur einen Abend wegen eines Headers.

406 und die Codes, mit denen er verwechselt wird

Endpunkte, die 406 zurückgeben

3 Endpunkte dieses Playgrounds antworten mit 406. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

Fragen zu HTTP 406

Ist es besser, den Statuscode 406 zurückzugeben oder den Accept-Header einfach zu ignorieren?
Viele APIs liefern trotzdem JSON, was pragmatisch ist, aber einen Client-Fehler verdeckt. 406 ist die ehrliche Antwort.
Führt Accept: */* jemals zu einem 406-Fehler?
Das sollte es nicht – das bedeutet, der Kunde würde alles nehmen.

Weitere Client-Fehlercodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert