Cheatsheet de Códigos HTTP
Significado y uso de los principales códigos de estado HTTP.
Filtra por número o categoría de estado.
1xx — Informativos
100 Continue El servidor ha recibido los encabezados y espera el cuerpo. 101 Switching Protocols El cliente solicita cambiar de protocolo (por ejemplo, a WebSocket). 102 Processing El servidor está procesando la solicitud, pero aún no hay respuesta (WebDAV). 2xx — Éxito
200 OK Solicitud exitosa. Respuesta estándar. 201 Created Recurso creado correctamente (POST o PUT). 202 Accepted Solicitud aceptada para procesamiento asíncrono. 204 No Content Éxito sin contenido que devolver. 206 Partial Content Respuesta parcial (descargas reanudables o rangos). 3xx — Redirecciones
301 Moved Permanently El recurso se ha movido definitivamente a otra URL. 302 Found Redirección temporal. 303 See Other Usado tras POST para redirigir con GET. 307 Temporary Redirect Redirección temporal manteniendo método y cuerpo. 308 Permanent Redirect Redirección permanente manteniendo método y cuerpo. 💡 Usa 301 para SEO permanente y 302/307 para redirecciones temporales.
4xx — Errores del cliente
400 Bad Request Solicitud mal formada o inválida. 401 Unauthorized Requiere autenticación (sin token válido). 403 Forbidden El cliente está autenticado pero no tiene permisos. 404 Not Found Recurso no encontrado. 405 Method Not Allowed Método HTTP no permitido para esa ruta. 409 Conflict Conflicto de estado (por ejemplo, registro duplicado). 410 Gone Recurso eliminado permanentemente. 422 Unprocessable Entity Error de validación (muy usado en APIs REST y GraphQL). 429 Too Many Requests Demasiadas peticiones — throttling o rate limiting. ⚠️ Los errores 4xx indican un problema en la solicitud o permisos del cliente.
5xx — Errores del servidor
500 Internal Server Error Error genérico del servidor. 501 Not Implemented Método no soportado o aún no implementado. 502 Bad Gateway El servidor actúa como proxy y recibió una respuesta inválida. 503 Service Unavailable Servidor temporalmente fuera de servicio (mantenimiento o sobrecarga). 504 Gateway Timeout El servidor proxy no recibió respuesta a tiempo. 505 HTTP Version Not Supported Versión HTTP no soportada. 💣 Los errores 5xx suelen requerir revisión del backend o la infraestructura.
🧩 Buenas prácticas en APIs
Usa 201 en POST exitosos Indica creación y devuelve el recurso nuevo o su ubicación. 404 coherente Devuelve 404 solo si el recurso realmente no existe. 422 para validación Ideal para errores de campos inválidos en JSON. 429 con Retry-After Incluye cabecera con segundos de espera. Usa 204 en DELETE Éxito sin cuerpo en eliminaciones.