Referencia de códigos de estado HTTP
| Código | Nombre | Significado |
|---|---|---|
| 100 | Continuar | El cliente debería continuar con el cuerpo de la solicitud |
| 101 | Cambio de protocolos | Actualización de protocolo aceptada (p. ej. a WebSocket) |
| 200 | OK | La solicitud tuvo éxito: la respuesta de éxito predeterminada |
| 201 | Creado | Se creó un nuevo recurso (éxito típico de POST) |
| 202 | Aceptado | En cola para procesamiento asíncrono, aún no completo |
| 204 | Sin contenido | Éxito con un cuerpo intencionalmente vacío |
| 301 | Movido permanentemente | El recurso tiene una nueva URL permanente: actualiza los enlaces; el valor SEO se transfiere |
| 302 | Encontrado | Redirección temporal (históricamente mal usada; ver 303/307) |
| 303 | Ver otro | Redirigir a un GET en otra URL (post/redirect/get) |
| 304 | No modificado | La copia en caché sigue siendo válida: revalida mediante ETag/Last-Modified |
| 307 | Redirección temporal | Redirección temporal que conserva el método y el cuerpo |
| 308 | Redirección permanente | Redirección permanente que conserva el método y el cuerpo |
| 400 | Solicitud incorrecta | El servidor no puede analizar/entender la solicitud |
| 401 | No autorizado | Autenticación requerida o fallida (a pesar del nombre, significa no autenticado) |
| 403 | Prohibido | Con autenticación o sin ella, el acceso se deniega |
| 404 | No encontrado | No hay ningún recurso en esta URL |
| 405 | Método no permitido | El método HTTP no es admitido para este recurso |
| 406 | No aceptable | Ninguna representación coincide con los encabezados Accept |
| 408 | Tiempo de espera de la solicitud agotado | El cliente tardó demasiado en enviar la solicitud |
| 409 | Conflicto | Conflicto de estado, p. ej. colisión de edición o creación duplicada |
| 410 | Ya no disponible | Eliminado permanentemente (más fuerte que 404: se usa deliberadamente) |
| 411 | Longitud requerida | Se requiere el encabezado Content-Length |
| 413 | Contenido demasiado grande | El cuerpo de la solicitud supera los límites del servidor |
| 414 | URI demasiado larga | La URL supera los límites del servidor |
| 415 | Tipo de medio no admitido | El Content-Type de la solicitud no es admitido |
| 418 | Soy una tetera | Código de broma RFC 2324, usado ocasionalmente para negarse a preparar café |
| 422 | Contenido no procesable | La sintaxis está bien pero la semántica no pasa la validación (a las API les encanta este) |
| 425 | Demasiado pronto | El servidor no está dispuesto a procesar una solicitud posiblemente repetida |
| 429 | Demasiadas solicitudes | Límite de velocidad alcanzado: retrocede, respeta Retry-After |
| 500 | Error interno del servidor | Fallo genérico del lado del servidor |
| 501 | No implementado | El servidor no admite la funcionalidad |
| 502 | Puerta de enlace incorrecta | Un proxy/gateway recibió una respuesta no válida del servidor ascendente |
| 503 | Servicio no disponible | Sobrecargado o fuera de servicio por mantenimiento: a menudo temporal, puede llevar Retry-After |
| 504 | Tiempo de espera de la puerta de enlace agotado | Un proxy/gateway agotó el tiempo esperando al servidor ascendente |
| 505 | Versión HTTP no admitida | La versión HTTP de la solicitud no es admitida |
Acerca de
Los códigos de estado son el resumen de un número del servidor de cada respuesta, agrupados por clase: 1xx informativos, 2xx éxito, 3xx redirección, 4xx el cliente se equivocó, 5xx el servidor se equivocó. La tabla da los códigos que los desarrolladores en activo realmente se encuentran, con los matices que importan en la práctica: 401 significa no autenticado a pesar de su nombre, 403 es una denegación independientemente del inicio de sesión, 422 es el fallo de validación de la API, 429 exige retroceso. Los códigos no enumerados (la cola larga de 1xx y los códigos experimentales) son lo bastante raros como para que la clase por sí sola te diga cómo manejarlos.
Preguntas frecuentes
¿Cuál es la diferencia entre 401 y 403?
401: no sabemos quién eres (autentícate). 403: lo sabemos, y aun así no puedes.
¿302 o 307 para una redirección temporal?
307 conserva el método y el cuerpo; 302 históricamente permitía a los clientes cambiar POST por GET. El trabajo nuevo debería usar 307 (o 308 para permanente).