Códigos de estado HTTP
Consulta cualquier código de estado HTTP en segundos. Busca por número, nombre o síntoma para ver qué significa el código, por qué ocurre, cómo solucionarlo y qué RFC lo define, incluidos los códigos no oficiales de nginx, Cloudflare, IIS y AWS.
Última actualización:
Cómo usar Códigos de estado HTTP
- Escribe un código de estado, como 404 o 503, en el cuadro de búsqueda y pulsa Buscar (o Intro) para ir directamente a él.
- Busca por síntoma, por ejemplo redirect, rate limit, cookie o ssl, para encontrar los códigos que coinciden.
- Filtra por clase con las pestañas 1xx–5xx, y desmarca los códigos no oficiales si solo quieres los registrados.
- Haz clic en un código para desplegar su significado, causas habituales y soluciones, la referencia a la especificación y una línea de estado de ejemplo.
- Descarga en CSV o JSON para reutilizar la lista en documentación, pruebas o una hoja de cálculo.
Las cinco clases de códigos de estado HTTP
| Clase | Significado | Códigos más habituales |
|---|---|---|
| 1xx Informativos | Respuesta provisional; la solicitud sigue en curso | 100 Continue, 101 Switching Protocols, 103 Early Hints |
| 2xx Éxito | La solicitud se recibió, se entendió y se aceptó | 200 OK, 201 Created, 204 No Content, 206 Partial Content |
| 3xx Redirección | Se necesita una acción adicional, normalmente seguir una cabecera Location | 301, 302, 304 Not Modified, 307, 308 |
| 4xx Error del cliente | La solicitud es incorrecta o no está permitida | 400, 401, 403, 404, 409, 422, 429 |
| 5xx Error del servidor | El servidor no pudo completar una solicitud válida | 500, 502, 503, 504 |
El primer dígito es todo lo que un cliente necesita estrictamente: RFC 9110 dice que un código no reconocido se trata como el código x00 de su clase, así que un 471 desconocido se gestiona como 400 Bad Request.
Comparativa de códigos de redirección
| Código | ¿Permanente? | ¿Conserva método y cuerpo? | Uso típico |
|---|---|---|---|
| 301 Moved Permanently | Sí | No (POST puede convertirse en GET) | Cambios de dominio, de HTTP a HTTPS, páginas renombradas |
| 302 Found | No | No (POST puede convertirse en GET) | Redirecciones temporales, flujos de inicio de sesión |
| 303 See Other | No | No, siempre GET | Después de enviar un formulario (Post/Redirect/Get) |
| 307 Temporary Redirect | No | Sí | Traslados temporales de endpoints de API |
| 308 Permanent Redirect | Sí | Sí | Traslados permanentes de endpoints de API y destinos de formularios |
Códigos de estado para API REST
Una API coherente usa un conjunto pequeño y predecible de códigos. Una buena correspondencia por defecto:
| Operación | Éxito | Errores típicos |
|---|---|---|
| GET /items/42 | 200 OK (304 si no ha cambiado) | 404 si el elemento no existe |
| POST /items | 201 Created con una cabecera Location | 400 JSON mal formado, 422 validación fallida, 409 duplicado |
| PUT o PATCH /items/42 | 200 OK con el elemento, o 204 No Content | 412 si falla If-Match, 404, 422 |
| DELETE /items/42 | 204 No Content | 404, o 409 si otros registros dependen de él |
| Tarea de larga duración | 202 Accepted más una URL de estado | 429 límite de solicitudes, 503 sobrecarga |
| Cualquier endpoint | – | 401 token ausente o caducado, 403 no permitido, 500 error de programación |
Consejo: devuelve siempre un cuerpo de error que explique el problema (por ejemplo, el formato application/problem+json de RFC 9457) y nunca envíes 200 OK con un mensaje de error dentro. La monitorización, las cachés, los reintentos y los buscadores dependen del código de estado.
Preguntas frecuentes
¿Qué significa un error 404?
404 Not Found significa que el servidor no encontró nada en la URL solicitada. Puede que el enlace esté mal escrito, que la página se haya movido sin redirección o que se haya eliminado. Corrige los enlaces rotos, añade redirecciones 301 para las páginas movidas o devuelve 410 Gone si la página se eliminó a propósito.
¿Cuál es la diferencia entre 401 y 403?
401 Unauthorized significa que no estás autenticado: inicia sesión o envía credenciales válidas y la solicitud podrá funcionar. 403 Forbidden significa que el servidor sabe quién eres (o no le importa) y aun así se niega; volver a iniciar sesión no servirá.
¿Debo usar una redirección 301 o 302?
Usa 301 (o 308) cuando una página se haya movido de forma permanente, por ejemplo tras una migración del sitio; los buscadores transfieren las señales de posicionamiento a la nueva URL. Usa 302 (o 307) para cambios temporales en los que la URL original deba mantener su lugar en los resultados de búsqueda. 307 y 308 además garantizan que no se cambie el método HTTP.
¿Qué causa un error 502 Bad Gateway?
Un proxy, balanceador de carga o CDN situado delante del sitio web recibió una respuesta no válida del servidor que tiene detrás. Normalmente la aplicación falló, se reinició o cerró la conexión. Los visitantes pueden reintentarlo pasado un minuto; los propietarios del sitio deben revisar los registros de la aplicación de origen.
¿Son reales los códigos como 499, 520 o 444?
Son no oficiales. No están en el registro de IANA, pero los usa software concreto: 444 y 499 nginx, del 520 al 527 Cloudflare, 440 y 449 Microsoft IIS. La herramienta los marca como no oficiales e indica su origen.
¿Qué códigos de estado se guardan en caché por defecto?
RFC 9110 indica que 200, 203, 204, 206, 300, 301, 308, 404, 405, 410, 414 y 501 se pueden almacenar en caché de forma heurística, es decir, las cachés pueden guardarlos incluso sin cabeceras explícitas de vigencia. El resto de códigos solo se guardan en caché si las cabeceras Cache-Control o Expires lo permiten.
¿Qué pasa si un servidor envía un código que no está registrado?
Los clientes lo tratan como el código x00 de su clase. Un cliente que recibe 299 lo gestiona como 200 OK, y un código 4xx desconocido se gestiona como 400 Bad Request. Escribe cualquier código de tres dígitos para ver la explicación.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.