Invítame a un café
Desarrollo

Códigos de estado HTTP

Guía de referencia de todos los códigos de estado HTTP con sus descripciones. Funciona en tu dispositivo: no se sube ni se almacena nada.

Mostrando 50 de 50 códigos de estado
100
Continuar
1xx

El cliente debe continuar con la solicitud. Se usa para indicar al cliente que se ha recibido la parte inicial de la solicitud.

Caso de uso: El servidor confirma la solicitud parcial; el cliente debe continuar.
101
Cambio de protocolos
1xx

El servidor cambia a un protocolo diferente, tal como solicitó el cliente.

Caso de uso: Negociación de actualización de HTTP a WebSocket.
102
Procesando
1xx

El servidor ha recibido la solicitud y la está procesando, pero todavía no hay ninguna respuesta disponible.

Caso de uso: Evitar tiempos de espera agotados en solicitudes WebDAV de larga duración.
103
Indicaciones tempranas
1xx

Se usa para devolver algunos encabezados de respuesta antes del mensaje HTTP final.

Caso de uso: Precargar recursos antes de que la respuesta completa esté lista.
200
OK
2xx

La solicitud se realizó correctamente. Su significado depende del método HTTP utilizado.

Caso de uso: Respuesta estándar para solicitudes GET, POST, PUT o DELETE correctas.
201
Creado
2xx

La solicitud se realizó correctamente y, como resultado, se creó un nuevo recurso.

Caso de uso: Solicitud POST que creó correctamente un nuevo usuario o registro.
202
Aceptado
2xx

La solicitud se recibió, pero todavía no se ha procesado. El procesamiento se realiza de forma asíncrona.

Caso de uso: Iniciar un trabajo en segundo plano o una tarea asíncrona a través de la API.
203
Información no autoritativa
2xx

Los metadatos devueltos no provienen del servidor de origen, sino de una copia local o de un tercero.

Caso de uso: Servidores proxy que transforman o almacenan en caché las respuestas.
204
Sin contenido
2xx

La solicitud se realizó correctamente, pero no hay contenido que enviar en la respuesta.

Caso de uso: DELETE o PUT que no necesita devolver datos.
206
Contenido parcial
2xx

El servidor entrega solo una parte del recurso debido a un encabezado de rango enviado por el cliente.

Caso de uso: Transmisión de video o descargas de archivos que se pueden reanudar.
207
Estado múltiple
2xx

Varios códigos de estado para varias sub-solicitudes en WebDAV.

Caso de uso: Respuestas PROPFIND de WebDAV con varios estados de recursos.
208
Ya reportado
2xx

Los miembros de una vinculación DAV ya se enumeraron en una respuesta anterior.

Caso de uso: Respuestas WebDAV que evitan repetir miembros.
226
IM utilizado
2xx

El servidor cumplió una solicitud GET y la respuesta es resultado de manipulaciones de instancia.

Caso de uso: Codificación delta en respuestas HTTP.
301
Movido permanentemente
3xx

La URL del recurso solicitado ha cambiado de forma permanente. La nueva URL se indica en la respuesta.

Caso de uso: Redirección permanente y amigable para el SEO de una URL antigua a una nueva.
302
Encontrado
3xx

La URL del recurso solicitado ha cambiado de forma temporal. Pueden producirse más cambios.

Caso de uso: Redirección temporal mientras se actualiza una página.
303
Ver otro
3xx

El servidor envía esta respuesta para indicar al cliente que obtenga el recurso solicitado en otra URI mediante una solicitud GET.

Caso de uso: Redirigir después del envío de un formulario POST.
304
No modificado
3xx

Se usa para el almacenamiento en caché. Indica al cliente que la respuesta no ha cambiado, por lo que puede usar su versión en caché.

Caso de uso: Validación de la caché del navegador con encabezados ETag o Last-Modified.
307
Redirección temporal
3xx

El servidor envía esta respuesta para indicar al cliente que obtenga el recurso solicitado en otra URI con el mismo método.

Caso de uso: Redirección temporal que conserva el método HTTP original.
308
Redirección permanente
3xx

Redirección permanente que conserva el método HTTP utilizado en la solicitud original.

Caso de uso: Migración permanente de un endpoint de API que conserva el método POST.
400
Solicitud incorrecta
4xx

El servidor no puede procesar la solicitud debido a una sintaxis incorrecta o a un formato de mensaje de solicitud no válido.

Caso de uso: Cuerpo JSON no válido o falta de parámetros de consulta obligatorios.
401
No autorizado
4xx

Se requiere autenticación y no se ha proporcionado o no es válida.

Caso de uso: Solicitud de API sin un token o una sesión válidos.
402
Pago requerido
4xx

Reservado para uso futuro; a veces se usa para requisitos de pago digital.

Caso de uso: Muro de pago o suscripción necesaria para acceder al contenido.
403
Prohibido
4xx

El cliente no tiene derechos de acceso al contenido. A diferencia del 401, la identidad es conocida.

Caso de uso: Usuario autenticado que intenta acceder a un recurso solo para administradores.
404
No encontrado
4xx

El servidor no puede encontrar el recurso solicitado. La URL no se reconoce.

Caso de uso: Acceder a una página o recurso que no existe.
405
Método no permitido
4xx

El método de la solicitud se conoce, pero no es compatible con el recurso de destino.

Caso de uso: Enviar DELETE a un endpoint que solo admite GET.
406
No aceptable
4xx

El servidor no puede generar una respuesta que coincida con la lista de valores aceptables definidos en los encabezados de la solicitud.

Caso de uso: Una API que solo devuelve JSON, pero el cliente pide XML.
408
Tiempo de espera de la solicitud agotado
4xx

El servidor no recibió un mensaje de solicitud completo dentro del tiempo que estaba dispuesto a esperar.

Caso de uso: El cliente tarda demasiado en enviar el cuerpo de la solicitud.
409
Conflicto
4xx

La solicitud entra en conflicto con el estado actual del servidor.

Caso de uso: Intentar crear un nombre de usuario que ya existe.
410
Desaparecido
4xx

El recurso de destino ya no está disponible y no volverá a estarlo.

Caso de uso: Contenido eliminado permanentemente sin dirección de reenvío.
411
Longitud requerida
4xx

El servidor rechazó la solicitud porque falta el campo de encabezado Content-Length.

Caso de uso: Solicitud POST sin el encabezado Content-Length.
413
Carga útil demasiado grande
4xx

El servidor rechaza la solicitud porque la carga útil es mayor de lo que está dispuesto a procesar.

Caso de uso: Subida de un archivo que supera el tamaño máximo permitido.
414
URI demasiado larga
4xx

La URI solicitada por el cliente es más larga de lo que el servidor está dispuesto a interpretar.

Caso de uso: Cadenas de consulta extremadamente largas en solicitudes GET.
415
Tipo de medio no compatible
4xx

El servidor rechaza aceptar la solicitud porque el formato de la carga útil no es compatible.

Caso de uso: Enviar XML a un endpoint de API que solo acepta JSON.
422
Entidad no procesable
4xx

El servidor entiende el tipo de contenido, pero no puede procesar las instrucciones.

Caso de uso: Datos de formulario con JSON válido pero con valores de campo no válidos.
423
Bloqueado
4xx

El recurso al que se intenta acceder está bloqueado.

Caso de uso: Recurso WebDAV bloqueado por otro usuario.
425
Demasiado pronto
4xx

Indica que el servidor no está dispuesto a arriesgarse a procesar una solicitud que podría reproducirse de nuevo.

Caso de uso: Datos tempranos (early data) en conexiones TLS 1.3.
429
Demasiadas solicitudes
4xx

El usuario ha enviado demasiadas solicitudes en un periodo de tiempo determinado (límite de frecuencia).

Caso de uso: Se superó el límite de frecuencia de la API; el cliente debe reducir el ritmo.
431
Campos de encabezado de la solicitud demasiado grandes
4xx

El servidor rechaza procesar la solicitud porque los campos de encabezado son demasiado grandes.

Caso de uso: Cookies o encabezados personalizados que superan los límites del servidor.
451
No disponible por motivos legales
4xx

El servidor deniega el acceso a un recurso debido a requerimientos legales.

Caso de uso: Contenido bloqueado por una retirada DMCA o una orden legal.
500
Error interno del servidor
5xx

El servidor se ha encontrado con una situación que no sabe cómo manejar.

Caso de uso: Excepción no controlada en el código del lado del servidor.
501
No implementado
5xx

El método de la solicitud no es compatible con el servidor y no se puede manejar.

Caso de uso: El servidor no admite el método PATCH en un recurso.
502
Puerta de enlace incorrecta
5xx

El servidor, actuando como puerta de enlace, obtuvo una respuesta no válida del servidor de origen.

Caso de uso: Nginx que recibe una respuesta incorrecta del servidor de aplicaciones de backend.
503
Servicio no disponible
5xx

El servidor no está listo para manejar la solicitud. Las causas habituales son el mantenimiento o la sobrecarga.

Caso de uso: Servidor en mantenimiento o con un tráfico elevado.
504
Tiempo de espera de la puerta de enlace agotado
5xx

El servidor que actúa como puerta de enlace no obtuvo una respuesta a tiempo del servidor de origen.

Caso de uso: La API de origen tarda demasiado en responder.
505
Versión de HTTP no compatible
5xx

La versión de HTTP usada en la solicitud no es compatible con el servidor.

Caso de uso: Cliente que usa HTTP/3 con un servidor que solo admite HTTP/1.1.
506
La variante también negocia
5xx

El servidor tiene un error de configuración interno en la negociación de contenido transparente.

Caso de uso: Negociación de contenido mal configurada en el servidor.
507
Almacenamiento insuficiente
5xx

El servidor no puede almacenar la representación necesaria para completar la solicitud.

Caso de uso: Un servidor WebDAV que se queda sin espacio de almacenamiento.
508
Bucle detectado
5xx

El servidor detectó un bucle infinito al procesar la solicitud.

Caso de uso: Solicitud WebDAV que crea referencias circulares.
510
No extendido
5xx

El servidor requiere extensiones adicionales en la solicitud para poder cumplirla.

Caso de uso: El cliente necesita enviar una solicitud del HTTP Extension Framework.
511
Se requiere autenticación de red
5xx

El cliente necesita autenticarse para obtener acceso a la red.

Caso de uso: Portal cautivo que exige iniciar sesión antes de acceder a internet.