Il server rifiuta il formato del corpo della richiesta. Confronta Content-Type, contenuto effettivo e formato previsto dall’endpoint.
Indice dei contenuti
Errore 415 Unsupported Media Type: significato
Le prime ipotesi da verificare per “Errore 415 Unsupported Media Type” sono content-Type sbagliato; JSON inviato come testo semplice.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “errore 415 Unsupported Media Type” compare durante un’operazione ripetibile.
- La funzione coinvolta in HTTP, browser e API non raggiunge il risultato previsto.
- Il log dell’area HTTP, browser e API registra un evento nello stesso minuto della prova.
- Il comportamento osservato in HTTP, browser e API cambia in base a utente, rete, file o configurazione.
Cause probabili
- Content-Type sbagliato
- JSON inviato come testo semplice
- Boundary multipart assente
- Endpoint che accetta un formato diverso
Diagnosi passo per passo
- Registrare Content-Type e corpo della richiesta
- Consultare il formato previsto dall’endpoint
- Validare JSON o XML
- Confrontare una chiamata funzionante
- Controllare se il proxy riscrive gli header
Log e dati da controllare
- DevTools, scheda Network
- log del server web o dell’applicazione
- log di proxy, CDN o WAF
Correzioni sicure
- Genera il corpo nel formato supportato e dichiara il Content-Type corrispondente.
- Per FormData nel browser lascia che il client imposti Content-Type e boundary: non scrivere manualmente multipart/form-data senza boundary.
- Controlla anche Content-Encoding se il corpo è compresso.
- Riprova con dati di test e verifica la risposta applicativa.
Verifica finale
- La stessa richiesta riceve la risposta prevista
- Metodo, header e corpo sono coerenti
- Non compaiono redirect o tentativi inattesi
- I log confermano il medesimo esito
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- Errore 415 Unsupported Media Type: API e upload
- Errore 205 Reset Content: significato e soluzioni
- HTTP 204 No Content con corpo inatteso
Fonti tecniche
Domande frequenti
Che cosa significa “Errore 415 Unsupported Media Type”?
Il server rifiuta il formato del corpo della richiesta. Confronta Content-Type, contenuto effettivo e formato previsto dall’endpoint.
Da cosa può dipendere “Errore 415 Unsupported Media Type”?
Le cause da verificare per “Errore 415 Unsupported Media Type” sono: content-Type sbagliato; JSON inviato come testo semplice; boundary multipart assente.
Quali controlli eseguire per “Errore 415 Unsupported Media Type”?
Genera il corpo nel formato supportato e dichiara il Content-Type corrispondente. Per FormData nel browser lascia che il client imposti Content-Type e boundary: non scrivere manualmente multipart/form-data senza boundary. Controlla anche Content-Encoding se il corpo è compresso. Riprova con dati di test e verifica la risposta applicativa.