Códigos de Estado HTTP

Referencia completa de códigos HTTP. Busca, filtra por categoría y aprende cuándo usar cada código.

Cómo funciona: Explora todos los códigos HTTP abajo. Usa la barra de búsqueda para encontrar códigos por número o nombre, o filtra por categoría (1xx-5xx). Haz clic en cualquier código para copiarlo.

Mostrando 34 de 34 códigos

100

Continuar

clic para copiar

El servidor ha recibido los headers y el cliente debe proceder a enviar el cuerpo de la solicitud.

101

Cambiando Protocolos

clic para copiar

El servidor está cambiando protocolos según lo solicitado por el cliente (ej: upgrade a WebSocket).

102

Procesando

clic para copiar

El servidor ha recibido y está procesando la solicitud, pero aún no hay respuesta disponible (WebDAV).

103

Indicaciones Tempranas

clic para copiar

Se usa para devolver algunos headers antes del mensaje final, permitiendo al navegador precargar recursos.

200

OK

clic para copiar

La solicitud fue exitosa. El significado depende del método HTTP: GET devuelve el recurso, POST devuelve el resultado de la acción.

201

Creado

clic para copiar

La solicitud fue exitosa y se creó un nuevo recurso. Típicamente usado como respuesta a solicitudes POST.

202

Aceptado

clic para copiar

La solicitud ha sido aceptada para procesamiento, pero aún no se ha completado. Usado para operaciones asíncronas.

204

Sin Contenido

clic para copiar

El servidor procesó la solicitud exitosamente pero no devuelve contenido. Respuesta común para operaciones DELETE.

206

Contenido Parcial

clic para copiar

El servidor entrega solo parte del recurso debido a un header Range enviado por el cliente.

207

Multi-Estado

clic para copiar

Respuesta que transmite información sobre múltiples recursos donde varios códigos de estado podrían ser apropiados (WebDAV).

301

Movido Permanentemente

clic para copiar

El recurso se ha movido permanentemente a una nueva URL. Los buscadores actualizarán sus enlaces.

302

Encontrado

clic para copiar

El recurso reside temporalmente en otra URL. El cliente debe seguir usando la URL original para futuras solicitudes.

303

Ver Otro

clic para copiar

La respuesta se puede encontrar en otra URL usando GET. Frecuentemente usado después de POST para redirigir a una página de confirmación.

304

No Modificado

clic para copiar

El recurso no ha sido modificado desde la última solicitud. Usado para caché — el cliente puede usar su versión guardada.

307

Redirección Temporal

clic para copiar

El recurso reside temporalmente en otra URL. A diferencia del 302, el método de solicitud no debe cambiar.

308

Redirección Permanente

clic para copiar

El recurso se ha movido permanentemente. A diferencia del 301, el método de solicitud no debe cambiar.

400

Solicitud Incorrecta

clic para copiar

El servidor no puede procesar la solicitud debido a sintaxis mal formada, parámetros inválidos o campos requeridos faltantes.

401

No Autorizado

clic para copiar

Se requiere autenticación. El cliente debe proporcionar credenciales válidas (API key, token o login) para acceder.

403

Prohibido

clic para copiar

El servidor entendió la solicitud pero se niega a autorizarla. La autenticación no ayudará — el usuario no tiene permiso.

404

No Encontrado

clic para copiar

El recurso solicitado no se encontró en el servidor. La URL puede ser incorrecta o el recurso pudo haber sido eliminado.

405

Método No Permitido

clic para copiar

El método HTTP usado no es soportado para este recurso. Por ejemplo, usar POST en un endpoint de solo lectura.

408

Tiempo de Espera Agotado

clic para copiar

El servidor agotó el tiempo de espera. El cliente tardó demasiado en enviar la solicitud completa.

409

Conflicto

clic para copiar

La solicitud entra en conflicto con el estado actual del servidor. Común en control de versiones o al intentar crear un recurso duplicado.

410

Desaparecido

clic para copiar

El recurso ya no está disponible y no lo estará de nuevo. A diferencia del 404, esta es una condición permanente.

413

Carga Muy Grande

clic para copiar

El cuerpo de la solicitud es más grande de lo que el servidor acepta. Común para límites de carga de archivos.

415

Tipo de Medio No Soportado

clic para copiar

El tipo de medio del cuerpo de la solicitud no es soportado. Por ejemplo, enviar XML cuando solo se acepta JSON.

418

Soy una Tetera

clic para copiar

El servidor se niega a preparar café porque es, permanentemente, una tetera. Una broma del April Fools' del RFC 2324.

422

Entidad No Procesable

clic para copiar

El servidor entiende el contenido pero no puede procesarlo. Usado para errores de validación — la sintaxis es correcta pero los datos son inválidos.

429

Demasiadas Solicitudes

clic para copiar

El usuario ha enviado demasiadas solicitudes en un período de tiempo (rate limiting). Revisa el header Retry-After.

500

Error Interno del Servidor

clic para copiar

El servidor encontró una condición inesperada que le impidió completar la solicitud. Un error genérico del servidor.

501

No Implementado

clic para copiar

El servidor no soporta la funcionalidad requerida. El método puede no ser reconocido.

502

Puerta de Enlace Incorrecta

clic para copiar

El servidor, actuando como gateway o proxy, recibió una respuesta inválida del servidor upstream.

503

Servicio No Disponible

clic para copiar

El servidor no puede manejar la solicitud temporalmente debido a mantenimiento o sobrecarga. Usualmente temporal.

504

Tiempo de Espera del Gateway

clic para copiar

El servidor, actuando como gateway o proxy, no recibió una respuesta a tiempo del servidor upstream.

¿Qué son los códigos de estado HTTP?

Los códigos de estado HTTP son números de tres dígitos devueltos por servidores web para indicar el resultado de una solicitud. Se agrupan en cinco categorías: 1xx (Informativo), 2xx (Éxito), 3xx (Redirección), 4xx (Error del Cliente) y 5xx (Error del Servidor). Entender estos códigos es esencial para desarrollo web, diseño de APIs y depuración de problemas de red.

Códigos HTTP más comunes

Los códigos más frecuentes son 200 OK (solicitud exitosa), 301 Movido Permanentemente (recurso reubicado), 404 No Encontrado (recurso no existe), 403 Prohibido (acceso denegado) y 500 Error Interno del Servidor (fallo del servidor). Estos cinco códigos representan la gran mayoría de respuestas HTTP que encontrarás en navegación web y desarrollo de APIs.

Códigos HTTP en APIs REST

Las APIs REST usan códigos de estado para comunicar el resultado de operaciones. Una API bien diseñada devuelve 200 para GET exitosos, 201 para POST exitosos (recurso creado), 204 para DELETE exitosos (sin contenido), 400 para entrada inválida, 401 para fallos de autenticación, 403 para fallos de autorización, 404 para recursos inexistentes y 422 para errores de validación.

Mejores prácticas con códigos HTTP

  • Devuelve el código más específico — 404 es mejor que un genérico 400
  • Usa 201 Created (no 200) cuando se crea un recurso via POST
  • Devuelve 204 No Content para operaciones DELETE exitosas
  • Usa 429 con header Retry-After para rate limiting
  • Nunca devuelvas 200 con error en el body — usa códigos 4xx/5xx
  • Usa 301 para redirecciones permanentes (SEO) y 307 para temporales