Códigos HTTP

Referencia de códigos de estado HTTP

Herramientas para desarrolladores

Cómo usar Códigos HTTP

  1. 1Busca un número de código o palabra clave
  2. 2Navega por categoría (2xx, 3xx, etc.)
  3. 3Haz clic en cualquier código para ver los detalles completos

Acerca de Códigos HTTP

Los códigos de estado HTTP son una referencia completa de todos los códigos de estado de respuesta HTTP estándar y comúnmente usados, organizados por categoría. Cada código incluye una descripción en lenguaje sencillo, cuándo es apropiado usarlo y ejemplos de escenarios del mundo real.

Los códigos de estado HTTP son el mecanismo principal por el cual los servidores comunican el resultado de una solicitud. Cada desarrollador que trabaja con APIs REST necesita saber qué significan 200, 201, 204, 301, 400, 401, 403, 404, 422, 429 y 500.

Busca o filtra por número de código, categoría (1xx-5xx) o palabra clave para encontrar cualquier código al instante.

Características principales de Códigos HTTP

  • Referencia completa de todos los códigos de estado HTTP estándar (1xx-5xx)
  • Incluye códigos no estándar pero ampliamente usados: 418, 429, 451
  • Descripción en lenguaje sencillo para cada código
  • Buscar por número de código o palabra clave
  • Filtrar por categoría: 1xx Informativo, 2xx Éxito, 3xx Redirección, 4xx Error del cliente, 5xx Error del servidor
  • Casos de uso comunes y ejemplos para cada código
  • Funciona completamente en el navegador — sin solicitudes al servidor
  • Búsqueda instantánea rápida sin demora de carga

Ejemplos

Buscar el código correcto para una creación de recurso exitosa

Encontrar qué código 2xx devolver desde un endpoint POST que crea un nuevo recurso.

Entrada

Búsqueda: "created" o código 201

Salida

201 Created — Usado cuando se ha creado un nuevo recurso. Incluye un encabezado Location apuntando a la URL del nuevo recurso.

Encontrar el código de error correcto para una respuesta de API con límite de tasa

Identificar el código estándar para comunicar que un cliente ha superado los límites de tasa de la API.

Entrada

Búsqueda: "rate limit" o código 429

Salida

429 Too Many Requests — Incluye un encabezado Retry-After indicando cuándo puede reintentar el cliente.

Casos de uso comunes

  • Buscar el código de estado correcto para devolver desde un endpoint de API REST
  • Depurar errores HTTP entendiendo qué significa un código específico
  • Diseñar el manejo de errores en código cliente de API para diferentes categorías de respuesta
  • Aprender semántica HTTP al construir o documentar una API
  • Revisar diseños de API para comprobar que los códigos de estado se usan apropiadamente
  • Referencia rápida durante el desarrollo sin salir de tu pestaña del navegador

Solución de problemas

Usar 200 OK para todas las respuestas incluyendo errores

Solución

Siempre usa el código de estado semánticamente correcto. Devolver 200 con un error en el cuerpo rompe la semántica HTTP.

Confundir 401 y 403

Solución

401 No autorizado significa que el cliente no está autenticado. 403 Prohibido significa que el cliente está autenticado pero carece de permiso.

Usar 404 para fallos de autenticación

Solución

Devolver 404 para recursos protegidos es una técnica de seguridad para prevenir la enumeración, pero puede confundir a los clientes legítimos. Documenta claramente tu elección.

Preguntas frecuentes

¿Están listados todos los códigos de estado HTTP?

Sí. Todos los códigos de estado RFC 7231 estándar más los códigos no oficiales de uso común como 418 (Soy una tetera), 429 (Demasiadas solicitudes) y 451 (No disponible por razones legales) están incluidos.

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

401 No autorizado indica que la solicitud requiere autenticación. 403 Prohibido indica que el servidor entiende la solicitud pero se niega a autorizarla.

¿Cuándo usar 200 vs 201 vs 204?

200 OK para solicitudes GET exitosas, 201 Created para solicitudes POST exitosas que crean un recurso, 204 No Content para DELETE o PATCH que no devuelven cuerpo.

¿Qué significa 422 Unprocessable Entity?

422 indica que la solicitud estaba bien formada pero era semánticamente incorrecta. Común en APIs REST para errores de validación.

¿Cuál es el código de estado correcto para una redirección?

301 Moved Permanently para cambios permanentes de URL, 302 Found para redirecciones temporales, y 307/308 para preservar el método HTTP durante la redirección.

¿Cuándo debería devolver 503 en lugar de 500?

500 Internal Server Error indica un fallo inesperado. 503 Service Unavailable indica que el servidor no puede manejar solicitudes temporalmente.

¿Se envían mis datos a un servidor?

No. La referencia de códigos de estado se carga estáticamente en tu navegador. No se transmiten consultas ni interacciones.

¿Qué significa el rango de códigos de estado 1xx?

Los códigos 1xx son informativos — indican que la solicitud fue recibida y el procesamiento continúa. El más común es 100 Continue.