Códigos de estado HTTP

Busca todos los códigos de estado HTTP, de 1xx a 5xx, con su significado y cuándo usarlos

Cómo consultar un código de estado HTTP

  1. 1

    Busca por código o palabra

    Escribe un número como 404, un nombre como "Not Found" o una palabra como "redirección" o "timeout" en el buscador. La lista se filtra mientras escribes.

  2. 2

    Filtra por clase

    Haz clic en 1xx, 2xx, 3xx, 4xx o 5xx para ver solo los códigos informativos, de éxito, de redirección, de error del cliente o de error del servidor.

  3. 3

    Abre un código

    Haz clic en un código para leer cuándo usarlo, o usa Expandir todos para abrir todos los de la lista actual.

  4. 4

    Cópialo

    Usa Copiar código o Copiar línea de estado (por ejemplo "404 Not Found") para pegarlo en tu código, documentación o informe de error.

Las cinco clases de códigos de estado HTTP

El primer dígito del código indica qué tipo de resultado informa el servidor. Conocer la clase suele bastar para entender una respuesta antes de leer los detalles.

  • 1xx Informativos: la petición se recibió y el proceso continúa (100, 101, 103)
  • 2xx Éxito: la petición se recibió, se entendió y se aceptó (200, 201, 204)
  • 3xx Redirección: el cliente debe dar otro paso, normalmente ir a otra URL (301, 302, 304)
  • 4xx Error del cliente: la petición es incorrecta o no está permitida (400, 401, 403, 404, 429)
  • 5xx Error del servidor: el servidor falló al atender una petición válida (500, 502, 503, 504)

Los códigos que más verás

200 OK, 201 Created y 204 No Content cubren casi todas las llamadas correctas de una API. 301 y 302 gestionan las redirecciones, y 304 indica al navegador que use su copia en caché. Entre los errores, 400 es una petición incorrecta, 401 que no estás autenticado, 403 que no tienes permiso, 404 que no se encontró y 429 que te están limitando la tasa.

Para problemas del servidor, 500 es el fallo genérico, 502 y 504 suelen indicar un proxy o balanceador que no alcanzó tu aplicación a tiempo, y 503 que el servicio no está disponible temporalmente, a menudo por mantenimiento.

301 vs 302 vs 307 vs 308

301 y 308 son redirecciones permanentes; 302 y 307 son temporales. La diferencia entre cada pareja es el método: 301 y 302 pueden convertir un POST en GET, mientras que 307 y 308 garantizan que el método y el cuerpo no cambian. Para SEO, usa 301 o 308 cuando una página se mueve para siempre, así los buscadores trasladan su posicionamiento a la nueva URL.

401 vs 403

Un 401 significa que el servidor no sabe quién eres: faltan las credenciales, caducaron o son incorrectas. Un 403 significa que el servidor sabe quién eres, pero no tienes permiso para hacerlo. Devuelve 401 para pedir inicio de sesión y 403 cuando volver a iniciar sesión no serviría de nada.

Elegir el código correcto para tu API

Usa códigos específicos en lugar de un 200 con un mensaje de error en el cuerpo. Devuelve 201 con la cabecera Location tras crear un recurso, 204 tras un borrado, 422 para errores de validación y 409 para conflictos. Clientes, cachés, herramientas de monitorización y buscadores dependen del código de estado para comportarse bien.

Privado y rápido

Toda la referencia se carga con la página y la búsqueda se ejecuta en tu navegador. Nada de lo que escribes se envía a un servidor.

Preguntas frecuentes sobre códigos HTTP

¿Qué es un código de estado HTTP?

Es un número de tres dígitos que el servidor envía al inicio de cada respuesta para indicar si la petición funcionó, necesita otro paso o falló, y por qué.

¿Cuál es la diferencia entre los errores 4xx y 5xx?

Los 4xx indican que el problema está en la petición (el cliente): URL incorrecta, falta de inicio de sesión, datos inválidos. Los 5xx indican que la petición era válida pero el servidor no pudo atenderla.

¿Qué significa 404 Not Found?

El servidor no encuentra el recurso en esa URL. Puede ser un error de escritura, una página eliminada o un ID incorrecto. Si la página se retiró a propósito y no volverá, 410 Gone es más preciso.

¿Cuándo usar 301 y cuándo 302?

Usa 301 cuando el cambio es permanente, como un dominio nuevo o una URL modificada, para que los buscadores trasladen el posicionamiento. Usa 302 cuando el cambio es temporal.

¿Qué diferencia hay entre 502, 503 y 504?

502 Bad Gateway: el proxy recibió una respuesta inválida de la aplicación. 503 Service Unavailable: el servidor está sobrecargado o en mantenimiento. 504 Gateway Timeout: la aplicación tardó demasiado en responder al proxy.

¿Es real el código 418 I am a teapot?

Sí. Viene de un RFC de broma del Día de los Inocentes (RFC 2324), se mantiene en el registro y a veces se usa como huevo de Pascua.

¿Es gratis?

Sí. Es gratis, no requiere registro y funciona por completo en tu navegador.