4xx · Errores del cliente
Error 415 Unsupported Media Type: qué significa y cómo solucionarlo
El error 415 Unsupported Media Type significa que el servidor no acepta el formato de los datos enviados, según la cabecera Content-Type. El caso típico: enviar JSON sin la cabecera Content-Type: application/json, o un formulario a una API que solo acepta JSON.
Qué significa el código 415
El servidor mira Content-Type para saber cómo leer el cuerpo. Si dice text/plain o no dice nada y la API espera JSON, rechaza la petición con 415.
Causas habituales del error 415
- Falta Content-Type: application/json en una petición con JSON.
- Enviar multipart/form-data a un endpoint que espera JSON (o al revés).
- Subir un tipo de fichero no permitido.
Cómo solucionar el error 415
- Añade la cabecera Content-Type correcta.
- En fetch(), pon headers: {"Content-Type": "application/json"} y body: JSON.stringify(datos).
Configuración y comandos
curl con JSON
bash
curl -X POST https://api.ejemplo.com/notas \
-H "Content-Type: application/json" \
-d '{"titulo": "Prueba"}'Ejemplo de respuesta
http
HTTP/1.1 415 Unsupported Media Type
Content-Type: application/json
{"error": "Content-Type must be application/json"}Herramientas para comprobarlo
Preguntas frecuentes
¿Por qué axios no da 415 y fetch sí?
axios pone Content-Type: application/json automáticamente al enviar un objeto; con fetch hay que indicarlo a mano.