Referencia de códigos de estado HTTP de balde

Utilizado para solicitudes con Expect: 100-continue. O servidor recoñece que está disposto a recibir o corpo antes de que o cliente o envíe. Raramente se ve en aplicacións web modernas.

Máis frecuentemente usado para actualizacións de WebSocket — o cliente solicita Upgrade: websocket e o servidor responde 101 para cambiar.

Resposta provisional de WebDAV enviada para evitar tempos de espera do cliente durante operacións longas. Deprecado — os servidores modernos non deberían envialo.

Permite que os servidores envíen encabezados Link (precarga/preconexión) mentres aínda se está preparando a resposta final, para que os navegadores poidan comezar a buscar recursos críticos máis axiña.

A resposta de éxito estándar. O significado depende do método HTTP: GET → recurso devolto, POST/PUT → acción completada.

Común despois dun POST. A resposta debe incluír un encabezado Location que apunte á URL do novo recurso.

Para operacións asincrónas — o servidor está poñendo na cola o traballo. O cliente debe sondear un punto final de estado ou volver máis tarde.

A solicitude foi aceptada, pero un intermediario (como un proxy de almacenamento en caché ou transformación) alterou o contido desde o servidor de orixe — por exemplo, recomprimindo imaxes. Raro na práctica.

A miúdo usado para operacións DELETE ou actualizacións PUT que non necesitan devolver un corpo. O cliente non debe abandonar a páxina actual.

Como 204, non se devolve un corpo — pero o cliente tamén se lle indica que reestableza o formulario ou vista que produciu a solicitude (ex. limpar os campos do formulario para a seguinte entrada).

Resposta a unha solicitude de rango. Utilizado por reprodutores de vídeo e xestores de descargas para retomar descargas interrompidas ou transmitir ficheiros grandes.

WebDAV: un corpo XML informa do resultado de varias suboperacións de forma independente — ex. un movemento en lote onde algúns elementos tiveron éxito e outros fallo.

WebDAV: utilizado dentro de respostas Multi-Status 207 para evitar listar repetidamente membros da mesma colección cando as unións crean bucles.

Codificación delta: o servidor devolve unha diferenza contra unha versión anterior en lugar do recurso completo, ahorando ancho de banda. Moi raramente implementado.

O servidor ofrece múltiples opcións (ex. diferentes formatos ou linguas) e o cliente debe escoller unha. Raramente usado, porque a negociación de contido automática adoita xestionar isto.

Usar para cambios de URL permanentes — os motores de busca actualizarán o seu índice. A autoridade SEO transfiérese á nova URL.

Indica que a redirección non é permanente. O almacenamento en caché é menos agresivo que 301. Úsao para cousas como 'requerido inicio de sesión, redirecionando a /login'.

Utilizado despois de envíos POST — a resposta di 'o teu POST funcionou, mira esta URL GET para o resultado'. Os navegadores sempre GET a nova URL.

Resposta a unha solicitude condicional (con encabezados If-None-Match ou If-Modified-Since). Ahorra ancho de banda — non se devolve corpo.

Se a orixinal foi POST, a redirección tamén usa POST. Alternativa moderna a 302 cando a preservación do método é importante.

Substitución moderna de 301 cando queres que as solicitudes POST sigan sendo POST despois da redirección.

Causas comúns: JSON malformado no corpo, parámetros de consulta inválidos ou campos obrigatorios ausentes. Comproba o corpo da solicitude e os encabezados.

O cliente debe incluír credenciais de autenticación (encabezado Authorization, cookie, token). 'Non autorizado' é unha incorreción — en realidade significa 'non autenticado'.

Orixinalmente destinado aos pagos dixitais. Uso moderno: ás veces as APIs devolven 402 cando un usuario excedeu a súa cota de pagamento.

Diferente de 401 — o usuario SÍ está conectado, pero a súa conta non ten permiso para este recurso. Comproba a lóxica de rol/permisos.

A URL é incorrecta, o recurso foi eliminado ou nunca existiu. Os servidores ás veces devolven 404 para agochar que 403 sería máis preciso.

Por exemplo, unha solicitude GET a un punto final que só acepta POST. A resposta debe incluír un encabezado Allow que liste os métodos válidos.

O cliente pediu un tipo de contido, idioma ou codificación (por medio de Accept, Accept-Language, Accept-Encoding) que o servidor non pode satisfacer. Moitos servidores saltan a negociación estrita e devolven un estándar.

Como 401, pero emitido por un proxy: o cliente debe enviar credenciais Proxy-Authorization. Visto en redes corporativas con proxies de autenticación.

O cliente tardou demasiado en enviar o corpo da solicitude ou mantivo a conexión inactiva. Intente a solicitude de novo.

Normalmente devolto para conflitos de edición concurrente ou creación de recursos duplicados (por exemplo, criar un usuario cun email que xa existe).

Máis forte que 404 — o servidor sabe explicitamente que o recurso EXISTIU pero foi eliminado de forma permanente. Os motores de busca o desindexarán.

A solicitude foi rexeitada porque carecía dun encabezado Content-Length e o servidor rexeita corpos de tamaño descoñecido. Engada o encabezado e reintente.

Devolto cando os encabezados condicionais como If-Match ou If-Unmodified-Since fallan — típicamente bloqueo optimista: alguén máis cambió o recurso desde a súa versión. Obteña de novo e reintente.

Común ao cargar ficheiros grandes. A configuración do servidor (nginx, apache) establece un tamaño máximo de corpo. Comprobe a configuración do servidor.

Normalmente causado por cadeas de consulta moi longas (por exemplo, codificar datos nun GET). Mude a un corpo POST ou aumente o límite do servidor se o controla.

Por exemplo, enviar application/xml a un servidor que só acepta application/json. Estabeleza correctamente o encabezado Content-Type.

O encabezado Range solicita unha porción que o ficheiro non ten — por exemplo, reanudar unha descarga máis aló do final do ficheiro. A resposta debe incluír Content-Range co tamaño real.

Enviado cando o servidor non soporta Expect: 100-continue. Algúns clientes envían este encabezado por defecto en POSTs grandes; deshabilitalo normalmente resolve o erro.

Unha broma do Día de Inocentes de 1998 (RFC 2324). Algunhas APIs reais o usan para bromas ou para marcar puntos finais obsoletos. Non para uso en produción.

Común coa reutilización de conexión HTTP/2: a solicitude chegou a un servidor non configurado para o nome de host de destino. O cliente debe reintentalo nunha nova conexión.

Por exemplo, JSON analizado correctamente pero un campo requirido faltaba, ou un valor de campo estaba fóra de rango. Común en respostas de validación de API REST.

WebDAV: o recurso de orixe ou destino está bloqueado por outro cliente, polo que a operación non pode proceder. Agarde a que o bloqueo se libere ou rómpao co token apropiado.

WebDAV: nunha cadea de operacións dependentes, unha acción anterior fallou, polo que esta non foi realizada. Mire a fallida anterior para a causa raíz.

Relacionado con TLS 1.3 0-RTT (datos tempranos): o servidor non correrá o risco de procesar unha solicitude posiblemente reproducida. O cliente debe reintentalo despois de que se complete o intercambio.

O servidor rexeita servir a solicitude sobre o protocolo actual pero o fará despois dunha actualización — a resposta inclúe un encabezado Upgrade que nomea o protocolo requirido.

O servidor esixe encabezados condicionais (como If-Match) para previr conflitos de actualización perdida. Obteña o recurso, capture o seu ETag, e reenvíeo con If-Match.

Decelere. A resposta debe incluír un encabezado Retry-After indicando cando reintentalo. Común con APIs que teñen cotas de solicitude.

Ou ben un encabezado ou o tamaño total do encabezado supera o límite — máis a miúdo causado por cookies sobredimensionadas. Limpe as cookies ou reduza o que a súa aplicación almacena nelas.

O recurso está bloqueado por razóns legais — censura, ordes xudiciais ou regulacións rexionais. O número é unha referencia á novela Fahrenheit 451.

Un comodín xenérico para erros do lado do servidor. Comprobe os rexistros do servidor para a causa real: excepción non manexada, erro de base de datos, etc.

Por exemplo, o servidor non recoñece o método HTTP. Raro na práctica — máis a miúdo verá 405.

Común en arquitecturas de microservizos. O seu equilibrador de carga ou proxy inverso obtivo unha resposta malformada do servizo de backend.

Ou ben está inactivo para mantemento ou está sobrecargado. A resposta debe incluír un encabezado Retry-After. A miúdo devolto durante despregamentos.

O servizo de backend non respondeu rápido o bastante. Comprobe a saúde do servizo anterior e as configuracións de tempo límite.

A versión principal de HTTP da solicitude non é soportada polo servidor. Case nunca se ve con clientes modernos.

A negociación de contido transparente terminó nunha volta: a variante escollida está configurada para negociar en si mesma. Indica un erro de configuración do servidor.

Específico de WebDAV na orixe pero ás veces usado por servidores xerais. Significa que o servidor non pode gardar a solicitude debido a restricións de almacenamento.

WebDAV: ao procesar unha solicitude Depth: infinity entrou nunha volta (por exemplo, ligazóns circulares). A operación foi terminada.

Do Marco de Extensión HTTP obsoleto: o servidor necesita máis información antes de poder cumprir a solicitude. Efectivamente non usado na web moderna.

Usado por portais cautivos (WiFi de hotel/aeroporto) para indicar que o usuario debe identificarse na rede antes de acceder a sitios externos.