Abre cada código para conocer su significado, un caso cotidiano y qué
revisar. Los códigos describen una respuesta: por sí solos no explican
toda la causa del fallo.
400 · Bad Request
La solicitud tiene un formato inválido.
Ejemplo: Envías un cuerpo JSON mal formado.
Qué revisar: Revisa parámetros, cuerpo y
documentación de la API.
401 · Unauthorized
Falta una autenticación válida.
Ejemplo: El token de acceso caducó.
Qué revisar: Comprueba la sesión o credenciales
sin publicarlas.
403 · Forbidden
El servidor rechaza el acceso.
Ejemplo: Tu cuenta no tiene permiso para esa
ruta.
Qué revisar: Revisa permisos y restricciones;
repetir el inicio de sesión puede no resolverlo.
404 · Not Found
No se encuentra el recurso solicitado; el estado no aclara si es
temporal o permanente.
Ejemplo: La página /contacto.html no existe.
Qué revisar: Revisa URL, nombre de archivo,
mayúsculas y ruta de publicación.
405 · Method Not Allowed
La ruta no admite el método utilizado.
Ejemplo: Haces POST a una ruta que solo permite
GET.
Qué revisar: Consulta la cabecera Allow y los
métodos de la API.
408 · Request Timeout
El servidor no recibió la solicitud completa a tiempo.
Ejemplo: La conexión se interrumpe mientras se
envía.
Qué revisar: Revisa la conexión; evita duplicar
operaciones al reintentar.
409 · Conflict
La operación entra en conflicto con el estado actual del recurso.
Ejemplo: Guardas una versión antigua de un
documento.
Qué revisar: Actualiza los datos y resuelve el
conflicto antes de enviar de nuevo.
410 · Gone
El recurso ya no está disponible y se considera una situación
probablemente permanente.
Ejemplo: Se retiró una página definitivamente.
Qué revisar: Actualiza los enlaces y busca una
alternativa.
413 · Content Too Large
El contenido enviado supera el tamaño permitido.
Ejemplo: Subes un archivo demasiado grande.
Qué revisar: Reduce el archivo o revisa el límite
del servidor.
415 · Unsupported Media Type
El formato enviado no está admitido.
Ejemplo: La API espera JSON y recibe otro tipo de
contenido.
Qué revisar: Revisa Content-Type y el formato
real del cuerpo.
422 · Unprocessable Content
El formato se entiende, pero el contenido no se puede procesar.
Ejemplo: Un formulario contiene valores que
incumplen las reglas.
Qué revisar: Lee los detalles de validación y
corrige los campos.
429 · Too Many Requests
Se enviaron demasiadas solicitudes en un período.
Ejemplo: Una búsqueda consulta la API en cada
pulsación.
Qué revisar: Reduce la frecuencia y respeta
Retry-After cuando exista.
500 · Internal Server Error
Un fallo inesperado impide completar la solicitud.
Ejemplo: El código del servidor falla al guardar.
Qué revisar: Revisa los registros del servidor;
el navegador no revela la causa exacta.
501 · Not Implemented
El servidor no soporta la funcionalidad necesaria.
Ejemplo: El servidor no reconoce o no implementa
un método.
Qué revisar: Revisa las capacidades del servidor
y la documentación.
502 · Bad Gateway
Un intermediario recibió una respuesta inválida del servidor de
origen.
Ejemplo: El proxy no obtiene una respuesta válida
de la aplicación.
Qué revisar: Revisa el servicio de origen y la
configuración del proxy.
503 · Service Unavailable
El servicio no puede atender ahora la petición.
Ejemplo: Mantenimiento o sobrecarga temporal.
Qué revisar: Espera según Retry-After si se
incluye y comprueba el servicio.
504 · Gateway Timeout
Un intermediario no recibió a tiempo la respuesta del servidor de
origen.
Ejemplo: La aplicación tarda demasiado en
responder al proxy.
Qué revisar: Revisa tiempos, servicios
dependientes y registros.