Statuscode 415 Unsupported Media Type

Was bedeutet der Fehler 415?

Der HTTP-Statuscode 415 „Unsupported Media Type“ bedeutet, dass ein Server den Inhalt einer Anfrage nicht im übermittelten Format verarbeiten kann. Die Anfrage erreicht den Server, wird jedoch abgelehnt, weil der Request-Body nicht zu den für die Ressource und HTTP-Methode zugelassenen Medientypen passt.

HTTP 415 gehört zur Klasse der 4xx-Statuscodes und kennzeichnet damit einen Fehler auf der Seite der Anfrage. Der Server ist grundsätzlich erreichbar, benötigt aber eine Anfrage mit einem unterstützten Medientyp, einer zulässigen Inhaltskodierung oder einem korrekt ausgezeichneten Datenformat. Auch technische SEO-Crawler ordnen 4xx-Antworten als clientseitige Fehler ein, die den Zugriff auf eine Ressource verhindern können.

Wie entsteht ein 415-Fehler?

Ein 415-Fehler entsteht meistens bei Anfragen mit einem Request-Body, beispielsweise bei POST, PUT oder PATCH. Der Client sendet Daten an eine API, ein Formular, ein Content-Management-System oder einen Datei-Upload, während der Server für diesen Endpunkt ein anderes Format erwartet.

• Der Header Content-Type nennt text/plain, obwohl der Endpunkt ausschließlich application/json akzeptiert.
• JSON-Daten werden gesendet, aber als application/x-www-form-urlencoded ausgezeichnet.
• Ein Datei-Upload enthält einen nicht zugelassenen Bild-, Video- oder Dokumenttyp.
• Der Server unterstützt die übermittelte Komprimierung oder Inhaltskodierung nicht.
• Ein API-Gateway, Web Application Firewall oder Framework lehnt den Medientyp bereits vor der eigentlichen Anwendung ab.

Ein typisches Beispiel ist eine API, die Produktdaten als JSON erwartet. Sendet der Client den korrekten JSON-Body mit dem Header Content-Type: text/plain, kann der Server mit HTTP 415 antworten. Dass die Daten inhaltlich wie JSON aussehen, reicht nicht aus, wenn der deklarierte Medientyp nicht zur Schnittstellendefinition passt.

Welche HTTP-Header sind betroffen?

Der Header Content-Type beschreibt den Medientyp des gesendeten Request-Bodys. Gängige Werte sind application/json für JSON, application/xml für XML, multipart/form-data für Datei-Uploads und application/x-www-form-urlencoded für klassisch übertragene Formulardaten.

Der Header Content-Encoding beschreibt eine zusätzliche Kodierung oder Komprimierung des Inhalts, etwa gzip. Kann der Server diese Kodierung nicht verarbeiten, ist ebenfalls eine 415-Antwort möglich. Der Fehler kann außerdem auftreten, wenn der Server den tatsächlichen Inhalt prüft und eine Abweichung vom angegebenen Medientyp erkennt.

Abgrenzung zu anderen 4xx-Statuscodes

Der Unterschied zwischen HTTP 415 und verwandten Clientfehlern liegt in der konkreten Ursache der Ablehnung. Bei 415 betrifft das Problem den Medientyp, das Datenformat oder die Inhaltskodierung der Anfrage.

Wie lässt sich HTTP 415 beheben?

Zur Behebung solltest Du zuerst die Dokumentation des betroffenen Endpunkts prüfen. Sie legt fest, welche HTTP-Methoden, Medientypen, Zeichensätze, Kodierungen und Dateiformate unterstützt werden. Bei APIs können diese Vorgaben beispielsweise in einer OpenAPI-Beschreibung dokumentiert sein.

• Vergleiche den gesendeten Content-Type mit den Anforderungen des Endpunkts.
• Prüfe, ob der Request-Body tatsächlich dem deklarierten Format entspricht.
• Entferne unnötige Parameter oder eine nicht unterstützte Content-Encoding.
• Kontrolliere bei Datei-Uploads Dateiendung, MIME-Type, Dateigröße und serverseitige Zulassungslisten.
• Untersuche Server-, Proxy- und Anwendungsprotokolle, um die ablehnende Systemkomponente zu identifizieren.

Bei einem JSON-Endpunkt besteht eine korrekte Anfrage beispielsweise aus dem Header Content-Type: application/json und einem syntaktisch gültigen JSON-Body. Bei einem Upload mit multipart/form-data sollte der Client die erforderliche Boundary normalerweise selbst erzeugen, da eine manuell unvollständig gesetzte Boundary die Verarbeitung verhindern kann.

Welche Bedeutung hat der Statuscode für SEO?

HTTP 415 betrifft klassische HTML-Seiten seltener als APIs, weil Suchmaschinen Webseiten überwiegend mit GET-Anfragen ohne Request-Body abrufen. Liefert eine indexierbare URL dennoch eine 415-Antwort an einen Suchmaschinen-Crawler, kann dieser den vorgesehenen Inhalt nicht abrufen und folglich nicht zuverlässig verarbeiten oder indexieren.

Für die technische SEO ist der Fehler außerdem relevant, wenn interne Systeme über APIs kommunizieren. Betroffen sein können Produktfeeds, Headless-CMS, Rendering-Dienste, interne Suchfunktionen, Formulare oder automatisierte Veröffentlichungsprozesse. Ein fehlerhafter Datenaustausch kann dazu führen, dass Inhalte fehlen, Seiten unvollständig erzeugt werden oder wichtige Aktualisierungen ausbleiben.

Regelmäßige Statuscode-Prüfungen gehören deshalb in einen technischen SEO-Audit. Crawler und Logfile-Analysen zeigen, welche URLs einen 4xx-Code zurückgeben und welcher Client, Endpunkt oder Prozess den Fehler ausgelöst hat. Automatisierte Technik-Crawler können Statuscode-Probleme fortlaufend erkennen und für die Fehleranalyse priorisieren.

Relevanz für SEA, Tracking und GEO

Im SEA kann HTTP 415 die Übertragung von Leads, Bestellungen oder Conversion-Daten beeinträchtigen, wenn Tracking-Endpunkte oder serverseitige Schnittstellen ein falsches Format erhalten. Die Anzeige selbst bleibt erreichbar, aber nachgelagerte Mess- und Übergabeprozesse können ausfallen oder unvollständige Daten liefern.

Für GEO, die Generative Engine Optimization, betrifft der Fehler vor allem technische Datenquellen für KI-Systeme. Wenn strukturierte Inhalte, Produktdaten oder Wissensbestände über eine API bereitgestellt werden, verhindert ein nicht unterstützter Medientyp den Abruf oder die Aktualisierung. Der Fehler beeinflusst die KI-Sichtbarkeit damit indirekt über fehlende oder veraltete Daten.

Bei Websites mit vielen Schnittstellen sollte die Prüfung von APIs, Statuscodes und generierten Seiten mit der allgemeinen technischen Onpage-Optimierung verbunden werden. So lassen sich Fehler nicht nur an einzelnen Requests beheben, sondern auch in Templates, Middleware, API-Clients und Deployment-Prozessen vermeiden.

Technische Statuscode-Fehler systematisch prüfen

Wiederkehrende 415-Antworten sollten anhand der betroffenen URL, HTTP-Methode, Request-Header, Nutzlast und Serverprotokolle untersucht werden. Wenn Schnittstellenfehler das Crawling, die Indexierung oder die Datenübertragung beeinträchtigen, kann eine strukturierte Analyse die Ursache zwischen Client, Server, Proxy und Anwendung eingrenzen.

Fragen zu deiner SEO-, SEA- oder GEO-Strategie? Die Online Solutions Group GmbH unterstützt Unternehmen bei der technischen Analyse und Priorisierung von Fehlern.

Häufige Fragen zum HTTP-Fehler 415