Desarrollo

Códigos de estado HTTP: lista completa y significado

Referencia con buscador de los códigos de estado HTTP: qué significa cada uno, su causa típica y cómo afecta al SEO.

También disponible en:EnglishPortuguêsFrançaisDeutschItalianoNederlandsPolski

100

Continue

El servidor ha recibido las cabeceras y el cliente debe enviar el cuerpo de la petición.

101

Switching Protocols

El servidor cambia de protocolo como se ha solicitado, normalmente a WebSocket.

200

OK

La respuesta correcta estándar. El cuerpo contiene el recurso solicitado.

201

Created

La petición ha tenido éxito y se ha creado un recurso. Su dirección se devuelve en la cabecera Location.

202

Accepted

La petición se ha aceptado para procesarla, pero aún no ha terminado. Habitual en tareas asíncronas.

204

No Content

Éxito sin contenido que devolver. Muy usado en DELETE y en actualizaciones con PUT.

206

Partial Content

El servidor devuelve solo una parte del recurso en respuesta a una cabecera Range, como en la reproducción de vídeo.

301

Moved Permanently

El recurso se ha movido de forma permanente. Transfiere las señales de posicionamiento a la nueva URL: es la redirección correcta para un cambio definitivo.

302

Found

Una redirección temporal. Los buscadores mantienen indexada la URL original, así que no la uses para un cambio definitivo.

304

Not Modified

La copia en caché sigue siendo válida. Se envía como respuesta a una petición condicional y ahorra ancho de banda.

307

Temporary Redirect

Como el 302, pero garantiza que el método HTTP no cambia al redirigir.

308

Permanent Redirect

Como el 301, pero conserva el método y el cuerpo de la petición.

400

Bad Request

El servidor no ha podido interpretar la petición. Suele ser un JSON mal formado o un parámetro obligatorio que falta.

401

Unauthorized

Falta autenticación o no es válida. Pese a su nombre, trata de autenticación y no de permisos.

403

Forbidden

La identidad se conoce, pero no tiene permiso para esta acción. Reintentar con las mismas credenciales no servirá.

404

Not Found

No hay ningún recurso en esa URL. Debe devolver un 404 real: una página de «no encontrado» que responde 200 es un soft 404.

405

Method Not Allowed

La URL existe pero no admite ese método HTTP. Incluye una cabecera Allow con los métodos aceptados.

409

Conflict

La petición entra en conflicto con el estado actual, por ejemplo una clave única duplicada o una versión desactualizada.

410

Gone

Eliminado de forma deliberada y permanente. Los buscadores retiran un 410 del índice antes que un 404.

418

I'm a teapot

Una broma del Día de los Inocentes de 1998 que navegadores y servidores han mantenido viva desde entonces.

422

Unprocessable Content

La sintaxis es válida pero el contenido no pasa las reglas de validación. Habitual en API JSON.

429

Too Many Requests

Se ha superado el límite de peticiones. Incluye una cabecera Retry-After para indicar cuándo reintentar.

500

Internal Server Error

Una excepción no controlada en el servidor. El código comodín cuando no hay otro más específico.

502

Bad Gateway

Un proxy ha recibido una respuesta inválida del servidor de origen. Normalmente la aplicación está caída o fallando.

503

Service Unavailable

Sobrecarga temporal o mantenimiento. Es el código correcto para una parada planificada, junto con Retry-After.

504

Gateway Timeout

Un proxy ha esperado demasiado la respuesta del origen. Suele apuntar a una consulta lenta o a una dependencia bloqueada.

Todo se calcula en tu navegador. Lo que escribes no se envía a ningún servidor.

Códigos de estado HTTP: para qué sirve

Los códigos de estado HTTP dicen mucho más de lo que la mayoría de API aprovechan. La diferencia entre un 301 y un 302 decide si se transfieren las señales de posicionamiento, y la que hay entre 401 y 403 es la que separa autenticación y autorización. Esta referencia con buscador cubre los códigos estándar con sus implicaciones prácticas.

Códigos de estado HTTP: cómo se usa

  1. Busca por número de código o por palabra clave.
  2. Filtra por clase: 2xx éxito, 3xx redirección, 4xx error del cliente, 5xx error del servidor.
  3. Lee el significado y la causa típica.
  4. Presta atención a las redirecciones y errores que afectan a la indexación.

Preguntas frecuentes

¿Qué diferencia hay entre una redirección 301 y una 302?

La 301 es permanente y transfiere las señales de posicionamiento a la nueva URL; la 302 es temporal e indica a los buscadores que mantengan indexada la original. Usar una 302 para un cambio definitivo es un error común y costoso.

¿Cuándo devuelvo un 404 y cuándo un 410?

El 404 significa «no encontrado», quizá temporalmente. El 410 indica que el recurso se ha eliminado de forma deliberada y permanente, y los buscadores suelen retirarlo del índice antes.

¿Qué es un soft 404?

Una página que le dice al usuario «no encontrado» pero devuelve un código 200. Los buscadores la indexan como una página real y malgastan presupuesto de rastreo. Las aplicaciones de una sola página los generan con mucha facilidad.

¿Qué diferencia hay entre 401 y 403?

El 401 indica que no te has autenticado, así que unas credenciales podrían ayudar. El 403 indica que estás autenticado pero no tienes permiso, y reintentar con la misma identidad no servirá.