Desarrollador

Códigos de estado HTTP

Busca un código HTTP: significado y cuándo usarlo.

  • Instantánea
  • Gratis
  • Privada (procesada localmente)
  • Sin registro
200OK
Éxito

La solicitud tuvo éxito.

201Created
Éxito

Recurso creado con éxito.

202Accepted
Éxito

Aceptada, en proceso.

204No Content
Éxito

Éxito, sin contenido.

206Partial Content
Éxito

Contenido parcial (rango).

301Moved Permanently
Redirección

Movido permanentemente a otra URL.

302Found
Redirección

Redirección temporal.

304Not Modified
Redirección

No modificado, usa la caché.

307Temporary Redirect
Redirección

Redirección temporal, método conservado.

308Permanent Redirect
Redirección

Redirección permanente, método conservado.

400Bad Request
Error de cliente

Solicitud mal formada del cliente.

401Unauthorized
Error de cliente

Autenticación requerida o fallida.

403Forbidden
Error de cliente

Acceso prohibido, sin permisos.

404Not Found
Error de cliente

Recurso no encontrado.

405Method Not Allowed
Error de cliente

Método HTTP no permitido aquí.

409Conflict
Error de cliente

Conflicto con el estado actual.

410Gone
Error de cliente

Recurso eliminado permanentemente.

418I'm a teapot
Error de cliente

Soy una tetera (broma de abril).

422Unprocessable Entity
Error de cliente

Sintaxis válida pero no procesable.

429Too Many Requests
Error de cliente

Demasiadas solicitudes, baja el ritmo.

500Internal Server Error
Error de servidor

Error interno del servidor.

501Not Implemented
Error de servidor

Funcionalidad no implementada.

502Bad Gateway
Error de servidor

Respuesta inválida del servidor upstream.

503Service Unavailable
Error de servidor

Servicio no disponible (sobrecarga, mantenimiento).

504Gateway Timeout
Error de servidor

Tiempo agotado con servidor upstream.

El diccionario de códigos HTTP, a una búsqueda

Cuando una petición web falla, el servidor devuelve un código de tres cifras. Esta herramienta los reúne y explica: escribe un número (404) o una frase («not found»), filtra por clase y lee el significado y el uso correcto de cada código.

  1. Busca

    Por número, por frase o por clase («4» para los 4xx).

  2. Lee la ficha

    Código, frase oficial, categoría y descripción.

  3. Elige el código correcto

    Para tu API, redirección o página de error.

Las cuatro grandes familias

ClaseSentidoEjemplos
2xxÉxito200 OK, 201 Created, 204 No Content
3xxRedirección301 Moved, 302 Found, 304 Not Modified
4xxError de cliente400, 401, 403, 404, 429
5xxError de servidor500, 502, 503, 504

Reflejo de depuración: la primera cifra indica el bando. Un 4xx se corrige en la petición (URL, permisos, formato); un 5xx en el servidor (código, configuración, sobrecarga).

Preguntas frecuentes

¿Qué significan las clases 2xx, 3xx, 4xx, 5xx?

La primera cifra da la categoría: 2xx = éxito, 3xx = redirección, 4xx = error del cliente (tu solicitud), 5xx = error del servidor. Un vistazo a la primera cifra ya dice de quién es el problema.

¿Cuál es la diferencia entre 401 y 403?

401 (Unauthorized) significa «identifícate»: falta la autenticación o falló. 403 (Forbidden) significa «sé quién eres, pero no tienes permiso». El primero se resuelve iniciando sesión, el segundo no.

¿Cuándo usar 301 en vez de 302?

301 (Moved Permanently) para una mudanza definitiva: los buscadores transfieren el posicionamiento a la nueva URL. 302 (Found) para un traslado temporal: la antigua URL sigue siendo la referencia. Equivocarse perjudica el SEO.

¿Existe de verdad el código 418?

¡Sí! 418 «I’m a teapot» viene de una broma del Día de los Inocentes de 1998 (protocolo de cafeteras). No tiene uso serio pero se volvió una broma de culto, y algunos servidores lo devuelven para peticiones absurdas.