Unsupported Media Type

Cuando el servidor no se traga tu archivo. Eso no me lo como.

⚠️ Error del Cliente

🤔 ¿Qué narices es esto?

El error 415 Unsupported Media Type es como intentar colar sushi en una pizzería: el servidor no reconoce el tipo de archivo o datos que le estás enviando y te lo rechaza.

Este error aparece cuando envías una petición con un Content-Type que el servidor no acepta o no sabe procesar. Suele pasar por:

Subes un archivo con formato no permitido
Envías datos con un Content-Type incorrecto
La API solo acepta ciertos tipos de datos
El servidor no tiene soporte para ese formato

⚡ Dato curioso

El 415 es el “eso no me lo trago” de los errores web. Muy común en APIs REST y formularios de subida de archivos.

No es el error más habitual, pero cuando aparece suele ser por enviar datos en un formato inesperado o no soportado.

📊 Info técnica

Código: 415
Tipo: Error del cliente
Categoría: 4xx
Descripción: Unsupported Media Type
Cacheable: No
Retryable: Sí (si cambias el tipo)

🎯 Frecuencia

Poco común
Más típico en APIs y subidas de archivos
Suele pillar por sorpresa
Normalmente por Content-Type incorrecto

🔧 Cómo arreglar este desastre

🚀 Para usuarios normales

Comprueba el tipo de archivo: Sube solo formatos permitidos.
Prueba desde otro navegador o app: Por si el problema es del cliente.
Contacta con soporte: Si no puedes hacer nada, pregunta al administrador.

🛠️ Para desarrolladores

Revisa el Content-Type: Asegúrate de enviar el tipo correcto en la cabecera.
Permite más tipos si es seguro: Añade soporte para los formatos necesarios.
Valida los archivos en el backend: No confíes solo en el frontend.
Actualiza la documentación: Indica claramente qué tipos acepta la API.
Gestiona los errores: Devuelve mensajes claros si el tipo no es soportado.

❌ Problemas típicos con 415

Archivos con formato raro:
Intentas subir un archivo que el servidor no reconoce.
Content-Type incorrecto:
Envías datos como text/plain cuando deberían ser application/json.
API muy estricta:
Solo acepta unos pocos tipos y rechaza el resto.
Falta de validación en el backend:
El servidor no comprueba bien los tipos y da errores inesperados.
Documentación desactualizada:
No queda claro qué tipos acepta el servidor y los usuarios se lían.

🚀 Respuesta rápida para emergencias

🔥 Si todo el sitio da 415:
1. Revisa la configuración de tipos permitidos.
2. Comprueba los Content-Type de las peticiones.
3. Actualiza la documentación.

⚡ Si solo una petición da 415:
1. Cambia el Content-Type.
2. Usa un formato soportado.
3. Contacta con soporte si es necesario.

🎯 Truco pro:
Valida siempre el Content-Type antes de enviar datos a una API.

💡 Tips pro

Valida el Content-Type antes de enviar
Permite solo los tipos necesarios
Actualiza la documentación de la API
Gestiona los errores con mensajes claros
Monitoriza los logs del servidor

⚡ Herramientas

Postman
curl
Google Chrome DevTools
Logs del servidor
Herramientas de monitorización