Referencia

Referencia de códigos de estado HTTP

Consulta códigos de respuesta HTTP por número, frase, categoría, origen, ciclo de vida y contexto real de diagnóstico. Esta referencia cubre códigos estándar RFC, extensiones WebDAV frecuentes, códigos de CDN y proxy, y diferencias importantes al depurar REST API, solicitudes del navegador, rastreo SEO, redirecciones, fallos de autenticación, límites de frecuencia, errores de gateway y timeouts upstream.

  • Busca por código, frase, categoría, código relacionado, proveedor o palabra clave de diagnóstico.
  • Compara la semántica de 1xx, 2xx, 3xx, 4xx y 5xx sin salir de la página.
  • Lee criterios prácticos para diseño de API, depuración en navegador, incidentes de CDN y diagnóstico del servidor.

1xx Informativos

Respuestas provisionales enviadas antes de la respuesta final. Normalmente las gestionan clientes HTTP, servidores, proxys o la capa de red del navegador.

100

Continue (Continuar)

El servidor recibió las cabeceras y permite que el cliente continúe enviando el cuerpo de la solicitud.

1xx Informativos Estándar No recomendado RFC 9110
Detalles

100 Continue (Continuar) indica que el servidor recibió las cabeceras y permite que el cliente continúe enviando el cuerpo de la solicitud. Es una respuesta informativa provisional; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el servidor recibió las cabeceras y permite que el cliente continúe enviando el cuerpo de la solicitud.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • Es útil al revisar contratos de API, informes de SEO, paneles de observabilidad, errores de SDK o pruebas automatizadas donde el número aparece sin suficiente contexto.
  • Debe compararse con 101, 102, 103, 200, 202, 204, 413, 417 cuando el síntoma sea parecido pero la causa exacta pueda cambiar la respuesta correcta.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor recibió las cabeceras y permite que el cliente continúe enviando el cuerpo de la solicitud.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 101, 102, 103, 200, 202, 204, 413, 417 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Revisa cabeceras, cuerpo de respuesta, logs de aplicación, logs de acceso, gateway y traceId antes de cambiar el comportamiento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 101, 102, 103, 200, 202, 204, 413, 417
101

Switching Protocols (Cambio de protocolo)

El servidor aceptó cambiar la conexión al protocolo solicitado, como ocurre en un handshake WebSocket.

1xx Informativos Estándar No recomendado RFC 9110
Detalles

101 Switching Protocols (Cambio de protocolo) indica que el servidor aceptó cambiar la conexión al protocolo solicitado, como ocurre en un handshake WebSocket. Es una respuesta informativa provisional; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el servidor aceptó cambiar la conexión al protocolo solicitado, como ocurre en un handshake WebSocket.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • Es útil al revisar contratos de API, informes de SEO, paneles de observabilidad, errores de SDK o pruebas automatizadas donde el número aparece sin suficiente contexto.
  • Debe compararse con 100, 200, 204, 400, 426 cuando el síntoma sea parecido pero la causa exacta pueda cambiar la respuesta correcta.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor aceptó cambiar la conexión al protocolo solicitado, como ocurre en un handshake WebSocket.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 100, 200, 204, 400, 426 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Revisa cabeceras, cuerpo de respuesta, logs de aplicación, logs de acceso, gateway y traceId antes de cambiar el comportamiento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 100, 200, 204, 400, 426
102

Processing (Procesando)

El servidor recibió la solicitud completa y sigue procesándola sin tener aún una respuesta final.

1xx Informativos Obsoleto No recomendado RFC 2518
Detalles

102 Processing (Procesando) indica que el servidor recibió la solicitud completa y sigue procesándola sin tener aún una respuesta final. Es una respuesta informativa provisional; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 2518. Está obsoleto y debe evitarse en diseños nuevos. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el servidor recibió la solicitud completa y sigue procesándola sin tener aún una respuesta final.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • Es útil al revisar contratos de API, informes de SEO, paneles de observabilidad, errores de SDK o pruebas automatizadas donde el número aparece sin suficiente contexto.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor recibió la solicitud completa y sigue procesándola sin tener aún una respuesta final.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 100, 103, 200, 202, 207, 408, 409, 423, 504, 507 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Revisa cabeceras, cuerpo de respuesta, logs de aplicación, logs de acceso, gateway y traceId antes de cambiar el comportamiento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 2518 Códigos relacionados: 100, 103, 200, 202, 207, 408, 409, 423, 504, 507
103

Early Hints (Pistas tempranas)

El servidor envía cabeceras preliminares para que el cliente pueda precargar recursos antes de la respuesta final.

1xx Informativos Estándar No recomendado RFC 8297
Detalles

103 Early Hints (Pistas tempranas) indica que el servidor envía cabeceras preliminares para que el cliente pueda precargar recursos antes de la respuesta final. Es una respuesta informativa provisional; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 8297. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el servidor envía cabeceras preliminares para que el cliente pueda precargar recursos antes de la respuesta final.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • Es útil al revisar contratos de API, informes de SEO, paneles de observabilidad, errores de SDK o pruebas automatizadas donde el número aparece sin suficiente contexto.
  • Debe compararse con 100, 102, 200, 204, 304, 404, 500 cuando el síntoma sea parecido pero la causa exacta pueda cambiar la respuesta correcta.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor envía cabeceras preliminares para que el cliente pueda precargar recursos antes de la respuesta final.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 100, 102, 200, 204, 304, 404, 500 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Revisa cabeceras, cuerpo de respuesta, logs de aplicación, logs de acceso, gateway y traceId antes de cambiar el comportamiento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 8297 Códigos relacionados: 100, 102, 200, 204, 304, 404, 500
104

Upload Resumption Supported (Reanudación de subida compatible)

El servidor indica que admite reanudar una subida interrumpida según el borrador de cargas reanudables.

1xx Informativos Temporal No recomendado draft-ietf-httpbis-resumable-upload-05
Detalles

104 Upload Resumption Supported (Reanudación de subida compatible) indica que el servidor indica que admite reanudar una subida interrumpida según el borrador de cargas reanudables. Es una respuesta informativa provisional; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es draft-ietf-httpbis-resumable-upload-05. Tiene carácter temporal o de borrador y requiere documentación explícita. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el servidor indica que admite reanudar una subida interrumpida según el borrador de cargas reanudables.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • Es útil al revisar contratos de API, informes de SEO, paneles de observabilidad, errores de SDK o pruebas automatizadas donde el número aparece sin suficiente contexto.
  • Debe compararse con 100, 102, 201, 202, 204, 206, 308, 409, 413, 416 cuando el síntoma sea parecido pero la causa exacta pueda cambiar la respuesta correcta.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor indica que admite reanudar una subida interrumpida según el borrador de cargas reanudables.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 100, 102, 201, 202, 204, 206, 308, 409, 413, 416 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Revisa cabeceras, cuerpo de respuesta, logs de aplicación, logs de acceso, gateway y traceId antes de cambiar el comportamiento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: draft-ietf-httpbis-resumable-upload-05 Códigos relacionados: 100, 102, 201, 202, 204, 206, 308, 409, 413, 416

2xx Correctos

Respuestas de éxito. Elegir el código correcto permite distinguir trabajo completado, recursos creados, tareas aceptadas, respuestas sin cuerpo y contenido parcial.

200

OK (Correcto)

La solicitud se completó correctamente y la respuesta contiene el resultado esperado.

2xx Correctos Estándar Recomendado RFC 9110
Detalles

200 OK (Correcto) indica que la solicitud se completó correctamente y la respuesta contiene el resultado esperado. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la solicitud se completó correctamente y la respuesta contiene el resultado esperado.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud se completó correctamente y la respuesta contiene el resultado esperado.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 201, 202, 204, 206, 304, 400, 500 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 201, 202, 204, 304, 400, 404, 500
201

Created (Creado)

La solicitud creó un recurso nuevo y la respuesta debe señalar su ubicación o representación.

2xx Correctos Estándar Recomendado RFC 9110
Detalles

201 Created (Creado) indica que la solicitud creó un recurso nuevo y la respuesta debe señalar su ubicación o representación. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la solicitud creó un recurso nuevo y la respuesta debe señalar su ubicación o representación.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud creó un recurso nuevo y la respuesta debe señalar su ubicación o representación.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 202, 204, 303, 409, 422 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 202, 204, 303, 409, 422
202

Accepted (Aceptado)

La solicitud fue aceptada para procesamiento posterior, pero el trabajo todavía no ha terminado.

2xx Correctos Estándar Recomendado RFC 9110
Detalles

202 Accepted (Aceptado) indica que la solicitud fue aceptada para procesamiento posterior, pero el trabajo todavía no ha terminado. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la solicitud fue aceptada para procesamiento posterior, pero el trabajo todavía no ha terminado.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud fue aceptada para procesamiento posterior, pero el trabajo todavía no ha terminado.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 100, 102, 200, 201, 204, 303, 409 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 201, 204, 102, 303
203

Non-Authoritative Information (Información no autorizada)

La respuesta correcta fue transformada por un intermediario y no es exactamente la representación original.

2xx Correctos Estándar Usar con cuidado RFC 9110
Detalles

203 Non-Authoritative Information (Información no autorizada) indica que la respuesta correcta fue transformada por un intermediario y no es exactamente la representación original. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando la respuesta correcta fue transformada por un intermediario y no es exactamente la representación original.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la respuesta correcta fue transformada por un intermediario y no es exactamente la representación original.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 204, 304, 502 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 204, 304
204

No Content (Sin contenido)

La operación se completó correctamente pero no hay cuerpo de respuesta que devolver.

2xx Correctos Estándar Recomendado RFC 9110
Detalles

204 No Content (Sin contenido) indica que la operación se completó correctamente pero no hay cuerpo de respuesta que devolver. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la operación se completó correctamente pero no hay cuerpo de respuesta que devolver.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la operación se completó correctamente pero no hay cuerpo de respuesta que devolver.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 201, 202, 205 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 201, 202, 205
205

Reset Content (Restablecer contenido)

La operación se completó y el cliente debería restablecer la vista o formulario que originó la solicitud.

2xx Correctos Estándar Usar con cuidado RFC 9110
Detalles

205 Reset Content (Restablecer contenido) indica que la operación se completó y el cliente debería restablecer la vista o formulario que originó la solicitud. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando la operación se completó y el cliente debería restablecer la vista o formulario que originó la solicitud.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la operación se completó y el cliente debería restablecer la vista o formulario que originó la solicitud.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 204 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 204
206

Partial Content (Contenido parcial)

El servidor devuelve solo una parte del recurso solicitada mediante cabeceras Range.

2xx Correctos Estándar Usar con cuidado RFC 9110
Detalles

206 Partial Content (Contenido parcial) indica que el servidor devuelve solo una parte del recurso solicitada mediante cabeceras Range. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor devuelve solo una parte del recurso solicitada mediante cabeceras Range.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor devuelve solo una parte del recurso solicitada mediante cabeceras Range.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 304, 416 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 304, 416
207

Multi-Status (Estado múltiple)

Una respuesta WebDAV incluye varios resultados independientes dentro de un mismo cuerpo.

2xx Correctos Estándar No recomendado RFC 4918
Detalles

207 Multi-Status (Estado múltiple) indica que una respuesta WebDAV incluye varios resultados independientes dentro de un mismo cuerpo. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 4918. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una respuesta WebDAV incluye varios resultados independientes dentro de un mismo cuerpo.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una respuesta WebDAV incluye varios resultados independientes dentro de un mismo cuerpo.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 206, 208, 424 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 4918 Códigos relacionados: 200, 206, 208, 424
208

Already Reported (Ya informado)

WebDAV evita repetir miembros de una colección que ya fueron informados en la misma respuesta.

2xx Correctos Estándar No recomendado RFC 5842
Detalles

208 Already Reported (Ya informado) indica que WebDAV evita repetir miembros de una colección que ya fueron informados en la misma respuesta. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 5842. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando WebDAV evita repetir miembros de una colección que ya fueron informados en la misma respuesta.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que WebDAV evita repetir miembros de una colección que ya fueron informados en la misma respuesta.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 207, 226, 508 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 5842 Códigos relacionados: 207, 226, 508
226

IM Used (IM usado)

El servidor aplicó una manipulación de instancia y devuelve el resultado de esa representación.

2xx Correctos Estándar No recomendado RFC 3229
Detalles

226 IM Used (IM usado) indica que el servidor aplicó una manipulación de instancia y devuelve el resultado de esa representación. Es una respuesta de éxito; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 3229. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el servidor aplicó una manipulación de instancia y devuelve el resultado de esa representación.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor aplicó una manipulación de instancia y devuelve el resultado de esa representación.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 206, 304 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 3229 Códigos relacionados: 200, 206, 304

3xx Redirección

Respuestas de redirección y caché. Afectan navegación del navegador, rastreadores, URL canónicas, clientes de API y comportamiento de reintento.

300

Multiple Choices (Varias opciones)

Existen varias representaciones posibles y el cliente o usuario debe elegir una.

3xx Redirección Estándar Usar con cuidado RFC 9110
Detalles

300 Multiple Choices (Varias opciones) indica que existen varias representaciones posibles y el cliente o usuario debe elegir una. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando existen varias representaciones posibles y el cliente o usuario debe elegir una.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que existen varias representaciones posibles y el cliente o usuario debe elegir una.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 301, 302, 303, 406 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 301, 302, 303, 406
301

Moved Permanently (Movido permanentemente)

El recurso se movió permanentemente a otra URL y los clientes deberían actualizar sus enlaces.

3xx Redirección Estándar Recomendado RFC 9110
Detalles

301 Moved Permanently (Movido permanentemente) indica que el recurso se movió permanentemente a otra URL y los clientes deberían actualizar sus enlaces. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el recurso se movió permanentemente a otra URL y los clientes deberían actualizar sus enlaces.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso se movió permanentemente a otra URL y los clientes deberían actualizar sus enlaces.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 302, 307, 308, 404, 410 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 302, 307, 308, 404, 410
302

Found (Encontrado)

El recurso se encuentra temporalmente en otra URL, aunque la semántica histórica puede cambiar el método.

3xx Redirección Estándar Recomendado RFC 9110
Detalles

302 Found (Encontrado) indica que el recurso se encuentra temporalmente en otra URL, aunque la semántica histórica puede cambiar el método. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el recurso se encuentra temporalmente en otra URL, aunque la semántica histórica puede cambiar el método.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso se encuentra temporalmente en otra URL, aunque la semántica histórica puede cambiar el método.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 301, 303, 307, 308, 401 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 301, 303, 307, 308
303

See Other (Ver otro)

El cliente debe consultar otra URL con GET para obtener el resultado de una operación.

3xx Redirección Estándar Usar con cuidado RFC 9110
Detalles

303 See Other (Ver otro) indica que el cliente debe consultar otra URL con GET para obtener el resultado de una operación. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el cliente debe consultar otra URL con GET para obtener el resultado de una operación.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el cliente debe consultar otra URL con GET para obtener el resultado de una operación.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 201, 202, 302, 307 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 201, 202, 302, 307
304

Not Modified (No modificado)

La representación en caché del cliente sigue siendo válida y no hace falta descargar el cuerpo de nuevo.

3xx Redirección Estándar Recomendado RFC 9110
Detalles

304 Not Modified (No modificado) indica que la representación en caché del cliente sigue siendo válida y no hace falta descargar el cuerpo de nuevo. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la representación en caché del cliente sigue siendo válida y no hace falta descargar el cuerpo de nuevo.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la representación en caché del cliente sigue siendo válida y no hace falta descargar el cuerpo de nuevo.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 204, 206, 412 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 204, 206, 412
305

Use Proxy (Usar proxy)

El acceso debía realizarse mediante un proxy indicado por el servidor, un comportamiento obsoleto.

3xx Redirección Obsoleto No recomendado RFC 9110
Detalles

305 Use Proxy (Usar proxy) indica que el acceso debía realizarse mediante un proxy indicado por el servidor, un comportamiento obsoleto. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Está obsoleto y debe evitarse en diseños nuevos. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el acceso debía realizarse mediante un proxy indicado por el servidor, un comportamiento obsoleto.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el acceso debía realizarse mediante un proxy indicado por el servidor, un comportamiento obsoleto.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 300, 307, 308 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 300, 307, 308
306

Unused (Sin uso)

El código está reservado por compatibilidad histórica y no tiene uso operativo actual.

3xx Redirección Reservado No recomendado RFC 9110
Detalles

306 Unused (Sin uso) indica que el código está reservado por compatibilidad histórica y no tiene uso operativo actual. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Está reservado o sin uso operativo normal. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el código está reservado por compatibilidad histórica y no tiene uso operativo actual.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el código está reservado por compatibilidad histórica y no tiene uso operativo actual.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 305, 307 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 305, 307
307

Temporary Redirect (Redirección temporal)

El recurso se redirige temporalmente a otra URL conservando el método y el cuerpo original.

3xx Redirección Estándar Recomendado RFC 9110
Detalles

307 Temporary Redirect (Redirección temporal) indica que el recurso se redirige temporalmente a otra URL conservando el método y el cuerpo original. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el recurso se redirige temporalmente a otra URL conservando el método y el cuerpo original.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso se redirige temporalmente a otra URL conservando el método y el cuerpo original.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 302, 303, 308 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 302, 303, 308
308

Permanent Redirect (Redirección permanente)

El recurso se redirige permanentemente a otra URL conservando el método y el cuerpo original.

3xx Redirección Estándar Recomendado RFC 9110
Detalles

308 Permanent Redirect (Redirección permanente) indica que el recurso se redirige permanentemente a otra URL conservando el método y el cuerpo original. Es una respuesta de redirección o caché; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el recurso se redirige permanentemente a otra URL conservando el método y el cuerpo original.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso se redirige permanentemente a otra URL conservando el método y el cuerpo original.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 301, 307 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 301, 307

4xx Error del cliente

Problemas de la solicitud del cliente: sintaxis inválida, autenticación, autorización, recursos ausentes, validación, conflictos, límites de frecuencia o restricciones legales.

400

Bad Request (Solicitud incorrecta)

La solicitud es inválida o no puede analizarse correctamente por sintaxis, formato o parámetros básicos.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

400 Bad Request (Solicitud incorrecta) indica que la solicitud es inválida o no puede analizarse correctamente por sintaxis, formato o parámetros básicos. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la solicitud es inválida o no puede analizarse correctamente por sintaxis, formato o parámetros básicos.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud es inválida o no puede analizarse correctamente por sintaxis, formato o parámetros básicos.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 403, 404, 409, 415, 422 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 401, 403, 404, 409, 422
401

Unauthorized (No autenticado)

La solicitud no incluye autenticación válida o necesita completar un reto de autenticación.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

401 Unauthorized (No autenticado) indica que la solicitud no incluye autenticación válida o necesita completar un reto de autenticación. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la solicitud no incluye autenticación válida o necesita completar un reto de autenticación.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud no incluye autenticación válida o necesita completar un reto de autenticación.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 403, 407, 419, 440 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 403, 407, 419, 440
402

Payment Required (Pago requerido)

El código está reservado para pagos y rara vez tiene una semántica interoperable en HTTP público.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

402 Payment Required (Pago requerido) indica que el código está reservado para pagos y rara vez tiene una semántica interoperable en HTTP público. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el código está reservado para pagos y rara vez tiene una semántica interoperable en HTTP público.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el código está reservado para pagos y rara vez tiene una semántica interoperable en HTTP público.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 403, 429 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 403, 429
403

Forbidden (Prohibido)

El servidor entiende la solicitud pero rechaza ejecutarla por permisos o políticas de acceso.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

403 Forbidden (Prohibido) indica que el servidor entiende la solicitud pero rechaza ejecutarla por permisos o políticas de acceso. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el servidor entiende la solicitud pero rechaza ejecutarla por permisos o políticas de acceso.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor entiende la solicitud pero rechaza ejecutarla por permisos o políticas de acceso.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 404, 451 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 401, 404, 451
404

Not Found (No encontrado)

El recurso solicitado no se encontró o el servidor no quiere revelar si existe.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

404 Not Found (No encontrado) indica que el recurso solicitado no se encontró o el servidor no quiere revelar si existe. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el recurso solicitado no se encontró o el servidor no quiere revelar si existe.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso solicitado no se encontró o el servidor no quiere revelar si existe.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 403, 410, 301 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 403, 410
405

Method Not Allowed (Método no permitido)

El método HTTP usado no está permitido para ese recurso aunque la ruta exista.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

405 Method Not Allowed (Método no permitido) indica que el método HTTP usado no está permitido para ese recurso aunque la ruta exista. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el método HTTP usado no está permitido para ese recurso aunque la ruta exista.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el método HTTP usado no está permitido para ese recurso aunque la ruta exista.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 404, 501 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 404, 501
406

Not Acceptable (No aceptable)

El servidor no puede producir una representación aceptable según las cabeceras de negociación del cliente.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

406 Not Acceptable (No aceptable) indica que el servidor no puede producir una representación aceptable según las cabeceras de negociación del cliente. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor no puede producir una representación aceptable según las cabeceras de negociación del cliente.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor no puede producir una representación aceptable según las cabeceras de negociación del cliente.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 300, 415 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 300, 415
407

Proxy Authentication Required (Autenticación de proxy requerida)

La solicitud debe autenticarse ante un proxy antes de poder continuar.

4xx Error del cliente Estándar No recomendado RFC 9110
Detalles

407 Proxy Authentication Required (Autenticación de proxy requerida) indica que la solicitud debe autenticarse ante un proxy antes de poder continuar. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando la solicitud debe autenticarse ante un proxy antes de poder continuar.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud debe autenticarse ante un proxy antes de poder continuar.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 403 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 401, 403
408

Request Timeout (Tiempo de solicitud agotado)

El servidor cerró la solicitud porque el cliente tardó demasiado en enviarla.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

408 Request Timeout (Tiempo de solicitud agotado) indica que el servidor cerró la solicitud porque el cliente tardó demasiado en enviarla. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor cerró la solicitud porque el cliente tardó demasiado en enviarla.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor cerró la solicitud porque el cliente tardó demasiado en enviarla.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 499, 504 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 499, 504
409

Conflict (Conflicto)

La solicitud entra en conflicto con el estado actual del recurso o del flujo de negocio.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

409 Conflict (Conflicto) indica que la solicitud entra en conflicto con el estado actual del recurso o del flujo de negocio. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la solicitud entra en conflicto con el estado actual del recurso o del flujo de negocio.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud entra en conflicto con el estado actual del recurso o del flujo de negocio.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 412, 422, 423 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 412, 422, 423
410

Gone (Eliminado)

El recurso existió pero fue eliminado de forma permanente y no se espera que vuelva.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

410 Gone (Eliminado) indica que el recurso existió pero fue eliminado de forma permanente y no se espera que vuelva. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el recurso existió pero fue eliminado de forma permanente y no se espera que vuelva.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso existió pero fue eliminado de forma permanente y no se espera que vuelva.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 404, 301, 451 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 404, 301, 451
411

Length Required (Longitud requerida)

El servidor exige Content-Length para procesar correctamente la solicitud.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

411 Length Required (Longitud requerida) indica que el servidor exige Content-Length para procesar correctamente la solicitud. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor exige Content-Length para procesar correctamente la solicitud.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor exige Content-Length para procesar correctamente la solicitud.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 413 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 413
412

Precondition Failed (Precondición fallida)

Una precondición como If-Match o If-Unmodified-Since no se cumple.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

412 Precondition Failed (Precondición fallida) indica que una precondición como If-Match o If-Unmodified-Since no se cumple. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando una precondición como If-Match o If-Unmodified-Since no se cumple.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una precondición como If-Match o If-Unmodified-Since no se cumple.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 304, 409, 428 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 304, 409, 428
413

Content Too Large (Contenido demasiado grande)

El cuerpo o contenido enviado es mayor de lo que el servidor está dispuesto a aceptar.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

413 Content Too Large (Contenido demasiado grande) indica que el cuerpo o contenido enviado es mayor de lo que el servidor está dispuesto a aceptar. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el cuerpo o contenido enviado es mayor de lo que el servidor está dispuesto a aceptar.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el cuerpo o contenido enviado es mayor de lo que el servidor está dispuesto a aceptar.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 411, 415, 494 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 411, 415
414

URI Too Long (URI demasiado larga)

La URI de la solicitud es demasiado larga para que el servidor la procese.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

414 URI Too Long (URI demasiado larga) indica que la URI de la solicitud es demasiado larga para que el servidor la procese. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la URI de la solicitud es demasiado larga para que el servidor la procese.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la URI de la solicitud es demasiado larga para que el servidor la procese.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 431, 494 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 431
415

Unsupported Media Type (Tipo de medio no admitido)

El tipo de medio o formato del cuerpo no es compatible con el endpoint.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

415 Unsupported Media Type (Tipo de medio no admitido) indica que el tipo de medio o formato del cuerpo no es compatible con el endpoint. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el tipo de medio o formato del cuerpo no es compatible con el endpoint.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el tipo de medio o formato del cuerpo no es compatible con el endpoint.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 406, 422 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 406, 422
416

Range Not Satisfiable (Rango no satisfacible)

El rango solicitado no puede satisfacerse para el recurso actual.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

416 Range Not Satisfiable (Rango no satisfacible) indica que el rango solicitado no puede satisfacerse para el recurso actual. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el rango solicitado no puede satisfacerse para el recurso actual.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el rango solicitado no puede satisfacerse para el recurso actual.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 200, 206, 404 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 200, 206
417

Expectation Failed (Expectativa fallida)

El servidor no puede cumplir la expectativa indicada por la cabecera Expect.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

417 Expectation Failed (Expectativa fallida) indica que el servidor no puede cumplir la expectativa indicada por la cabecera Expect. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor no puede cumplir la expectativa indicada por la cabecera Expect.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor no puede cumplir la expectativa indicada por la cabecera Expect.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 100, 400, 413 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 100, 400, 413
418

I'm a teapot (Soy una tetera)

Es un código humorístico definido para el protocolo HTCPCP y no debe usarse como contrato real.

4xx Error del cliente Reservado No recomendado RFC 9110
Detalles

418 I'm a teapot (Soy una tetera) indica que es un código humorístico definido para el protocolo HTCPCP y no debe usarse como contrato real. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Está reservado o sin uso operativo normal. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando es un código humorístico definido para el protocolo HTCPCP y no debe usarse como contrato real.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que es un código humorístico definido para el protocolo HTCPCP y no debe usarse como contrato real.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 501 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 501
419

Page Expired (Página caducada)

Una sesión, token CSRF o estado de página caducó según una convención de framework.

4xx Error del cliente No estándar Usar con cuidado Laravel / Web framework convention
Detalles

419 Page Expired (Página caducada) indica que una sesión, token CSRF o estado de página caducó según una convención de framework. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Laravel / Web framework convention. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando una sesión, token CSRF o estado de página caducó según una convención de framework.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • Es útil al revisar contratos de API, informes de SEO, paneles de observabilidad, errores de SDK o pruebas automatizadas donde el número aparece sin suficiente contexto.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una sesión, token CSRF o estado de página caducó según una convención de framework.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 401, 403, 440, 422 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Laravel / Web framework convention Códigos relacionados: 400, 401, 403, 440, 422
420

Enhance Your Calm (Reduce la frecuencia)

Una implementación no estándar pide reducir la frecuencia o calmar el volumen de solicitudes.

4xx Error del cliente No estándar No recomendado Twitter legacy API convention
Detalles

420 Enhance Your Calm (Reduce la frecuencia) indica que una implementación no estándar pide reducir la frecuencia o calmar el volumen de solicitudes. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Twitter legacy API convention. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una implementación no estándar pide reducir la frecuencia o calmar el volumen de solicitudes.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una implementación no estándar pide reducir la frecuencia o calmar el volumen de solicitudes.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 429, 403, 503 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Twitter legacy API convention Códigos relacionados: 429, 403, 503
421

Misdirected Request (Solicitud mal dirigida)

La solicitud llegó a un servidor que no está autorizado o configurado para responder por ese origen.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

421 Misdirected Request (Solicitud mal dirigida) indica que la solicitud llegó a un servidor que no está autorizado o configurado para responder por ese origen. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando la solicitud llegó a un servidor que no está autorizado o configurado para responder por ese origen.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud llegó a un servidor que no está autorizado o configurado para responder por ese origen.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 502 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 421, 502
422

Unprocessable Content (Contenido no procesable)

La sintaxis de la solicitud es válida pero sus valores no pasan la validación semántica.

4xx Error del cliente Estándar Recomendado RFC 9110
Detalles

422 Unprocessable Content (Contenido no procesable) indica que la sintaxis de la solicitud es válida pero sus valores no pasan la validación semántica. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando la sintaxis de la solicitud es válida pero sus valores no pasan la validación semántica.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la sintaxis de la solicitud es válida pero sus valores no pasan la validación semántica.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 409, 415 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 409, 415
423

Locked (Bloqueado)

El recurso está bloqueado, normalmente en un flujo WebDAV o de edición concurrente.

4xx Error del cliente Estándar Usar con cuidado RFC 4918
Detalles

423 Locked (Bloqueado) indica que el recurso está bloqueado, normalmente en un flujo WebDAV o de edición concurrente. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 4918. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el recurso está bloqueado, normalmente en un flujo WebDAV o de edición concurrente.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso está bloqueado, normalmente en un flujo WebDAV o de edición concurrente.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 409, 424, 507 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 4918 Códigos relacionados: 409, 424, 507
424

Failed Dependency (Dependencia fallida)

La operación falla porque dependía de otra acción que también falló.

4xx Error del cliente Estándar No recomendado RFC 4918
Detalles

424 Failed Dependency (Dependencia fallida) indica que la operación falla porque dependía de otra acción que también falló. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 4918. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando la operación falla porque dependía de otra acción que también falló.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la operación falla porque dependía de otra acción que también falló.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 207, 409, 423 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 4918 Códigos relacionados: 207, 409, 423
425

Too Early (Demasiado pronto)

El servidor no quiere procesar la solicitud porque podría repetirse de forma insegura demasiado pronto.

4xx Error del cliente Estándar Usar con cuidado RFC 8470
Detalles

425 Too Early (Demasiado pronto) indica que el servidor no quiere procesar la solicitud porque podría repetirse de forma insegura demasiado pronto. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 8470. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor no quiere procesar la solicitud porque podría repetirse de forma insegura demasiado pronto.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor no quiere procesar la solicitud porque podría repetirse de forma insegura demasiado pronto.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 409, 429 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 8470 Códigos relacionados: 400, 409, 429
426

Upgrade Required (Actualización requerida)

El servidor exige que el cliente use una versión o protocolo diferente para continuar.

4xx Error del cliente Estándar Usar con cuidado RFC 9110
Detalles

426 Upgrade Required (Actualización requerida) indica que el servidor exige que el cliente use una versión o protocolo diferente para continuar. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor exige que el cliente use una versión o protocolo diferente para continuar.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor exige que el cliente use una versión o protocolo diferente para continuar.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 101, 400, 505 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 101, 400, 505
428

Precondition Required (Precondición requerida)

El servidor requiere precondiciones para evitar actualizaciones perdidas o escrituras concurrentes inseguras.

4xx Error del cliente Estándar Recomendado RFC 6585
Detalles

428 Precondition Required (Precondición requerida) indica que el servidor requiere precondiciones para evitar actualizaciones perdidas o escrituras concurrentes inseguras. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 6585. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el servidor requiere precondiciones para evitar actualizaciones perdidas o escrituras concurrentes inseguras.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor requiere precondiciones para evitar actualizaciones perdidas o escrituras concurrentes inseguras.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 409, 412 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 6585 Códigos relacionados: 409, 412
429

Too Many Requests (Demasiadas solicitudes)

El cliente superó un límite de frecuencia, cuota o volumen de solicitudes.

4xx Error del cliente Estándar Recomendado RFC 6585
Detalles

429 Too Many Requests (Demasiadas solicitudes) indica que el cliente superó un límite de frecuencia, cuota o volumen de solicitudes. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 6585. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el cliente superó un límite de frecuencia, cuota o volumen de solicitudes.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el cliente superó un límite de frecuencia, cuota o volumen de solicitudes.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 403, 503 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 6585 Códigos relacionados: 403, 503
430

Request Header Fields Too Large (Campos de cabecera demasiado grandes)

Una implementación no estándar considera demasiado grandes los campos de cabecera de la solicitud.

4xx Error del cliente No estándar No recomendado Non-standard platform convention
Detalles

430 Request Header Fields Too Large (Campos de cabecera demasiado grandes) indica que una implementación no estándar considera demasiado grandes los campos de cabecera de la solicitud. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Non-standard platform convention. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una implementación no estándar considera demasiado grandes los campos de cabecera de la solicitud.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una implementación no estándar considera demasiado grandes los campos de cabecera de la solicitud.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 431, 494 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Non-standard platform convention Códigos relacionados: 400, 431, 494
431

Request Header Fields Too Large (Campos de cabecera demasiado grandes)

Uno o varios campos de cabecera de la solicitud son demasiado grandes.

4xx Error del cliente Estándar Recomendado RFC 6585
Detalles

431 Request Header Fields Too Large (Campos de cabecera demasiado grandes) indica que uno o varios campos de cabecera de la solicitud son demasiado grandes. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 6585. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando uno o varios campos de cabecera de la solicitud son demasiado grandes.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que uno o varios campos de cabecera de la solicitud son demasiado grandes.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 414, 494 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 6585 Códigos relacionados: 400, 414, 494
440

Login Timeout (Sesión de inicio caducada)

Una convención de Microsoft IIS indica que la sesión de inicio de sesión expiró.

4xx Error del cliente No estándar Usar con cuidado Microsoft IIS
Detalles

440 Login Timeout (Sesión de inicio caducada) indica que una convención de Microsoft IIS indica que la sesión de inicio de sesión expiró. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Microsoft IIS. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando una convención de Microsoft IIS indica que la sesión de inicio de sesión expiró.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una convención de Microsoft IIS indica que la sesión de inicio de sesión expiró.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 403, 419 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Microsoft IIS Códigos relacionados: 401, 403, 419
444

No Response (Sin respuesta)

Nginx cerró la conexión sin enviar respuesta HTTP al cliente.

4xx Error del cliente No estándar No recomendado Nginx
Detalles

444 No Response (Sin respuesta) indica que Nginx cerró la conexión sin enviar respuesta HTTP al cliente. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Nginx. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Nginx cerró la conexión sin enviar respuesta HTTP al cliente.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Nginx cerró la conexión sin enviar respuesta HTTP al cliente.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 403, 499 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Nginx Códigos relacionados: 400, 403, 499
449

Retry With (Reintentar con datos adicionales)

Una convención de Microsoft indica que la solicitud debe reintentarse con información adicional.

4xx Error del cliente No estándar No recomendado Microsoft IIS
Detalles

449 Retry With (Reintentar con datos adicionales) indica que una convención de Microsoft indica que la solicitud debe reintentarse con información adicional. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Microsoft IIS. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una convención de Microsoft indica que la solicitud debe reintentarse con información adicional.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una convención de Microsoft indica que la solicitud debe reintentarse con información adicional.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 401, 428 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Microsoft IIS Códigos relacionados: 400, 401, 428
450

Blocked by Windows Parental Controls (Bloqueado por control parental)

Una convención antigua de Microsoft indica bloqueo por controles parentales de Windows.

4xx Error del cliente No estándar No recomendado Microsoft IIS
Detalles

450 Blocked by Windows Parental Controls (Bloqueado por control parental) indica que una convención antigua de Microsoft indica bloqueo por controles parentales de Windows. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Microsoft IIS. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una convención antigua de Microsoft indica bloqueo por controles parentales de Windows.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una convención antigua de Microsoft indica bloqueo por controles parentales de Windows.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 403, 451 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Microsoft IIS Códigos relacionados: 403, 451
451

Unavailable For Legal Reasons (No disponible por razones legales)

El recurso no está disponible por una restricción legal, orden o política aplicable.

4xx Error del cliente Estándar Usar con cuidado RFC 7725
Detalles

451 Unavailable For Legal Reasons (No disponible por razones legales) indica que el recurso no está disponible por una restricción legal, orden o política aplicable. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 7725. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el recurso no está disponible por una restricción legal, orden o política aplicable.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el recurso no está disponible por una restricción legal, orden o política aplicable.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 403, 404, 410 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 7725 Códigos relacionados: 403, 404, 410
460

Client Closed Connection (Conexión cerrada por el cliente)

Un balanceador o intermediario detectó que el cliente cerró la conexión antes de completar la respuesta.

4xx Error del cliente No estándar No recomendado AWS Elastic Load Balancing
Detalles

460 Client Closed Connection (Conexión cerrada por el cliente) indica que un balanceador o intermediario detectó que el cliente cerró la conexión antes de completar la respuesta. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es AWS Elastic Load Balancing. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando un balanceador o intermediario detectó que el cliente cerró la conexión antes de completar la respuesta.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que un balanceador o intermediario detectó que el cliente cerró la conexión antes de completar la respuesta.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 408, 499, 504 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: AWS Elastic Load Balancing Códigos relacionados: 408, 499, 504
463

Too Many Forwarded IPs (Demasiadas IP reenviadas)

AWS o un intermediario recibió demasiadas IP en cabeceras de reenvío.

4xx Error del cliente No estándar No recomendado AWS Elastic Load Balancing
Detalles

463 Too Many Forwarded IPs (Demasiadas IP reenviadas) indica que AWS o un intermediario recibió demasiadas IP en cabeceras de reenvío. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es AWS Elastic Load Balancing. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando AWS o un intermediario recibió demasiadas IP en cabeceras de reenvío.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que AWS o un intermediario recibió demasiadas IP en cabeceras de reenvío.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 431, 494 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: AWS Elastic Load Balancing Códigos relacionados: 400, 431, 494
464

Incompatible Protocol (Protocolo incompatible)

AWS o un intermediario detectó una incompatibilidad de protocolo o puerto entre cliente y destino.

4xx Error del cliente No estándar No recomendado AWS Elastic Load Balancing
Detalles

464 Incompatible Protocol (Protocolo incompatible) indica que AWS o un intermediario detectó una incompatibilidad de protocolo o puerto entre cliente y destino. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es AWS Elastic Load Balancing. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando AWS o un intermediario detectó una incompatibilidad de protocolo o puerto entre cliente y destino.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que AWS o un intermediario detectó una incompatibilidad de protocolo o puerto entre cliente y destino.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 426, 502 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: AWS Elastic Load Balancing Códigos relacionados: 400, 426, 502
494

Request Header Too Large (Cabecera de solicitud demasiado grande)

Nginx rechazó la solicitud porque la cabecera era demasiado grande.

4xx Error del cliente No estándar No recomendado Nginx
Detalles

494 Request Header Too Large (Cabecera de solicitud demasiado grande) indica que Nginx rechazó la solicitud porque la cabecera era demasiado grande. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Nginx. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Nginx rechazó la solicitud porque la cabecera era demasiado grande.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Nginx rechazó la solicitud porque la cabecera era demasiado grande.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 431, 414 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Nginx Códigos relacionados: 400, 414, 431
495

SSL Certificate Error (Error de certificado SSL)

Nginx detectó un error al validar el certificado SSL del cliente.

4xx Error del cliente No estándar No recomendado Nginx
Detalles

495 SSL Certificate Error (Error de certificado SSL) indica que Nginx detectó un error al validar el certificado SSL del cliente. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Nginx. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Nginx detectó un error al validar el certificado SSL del cliente.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Nginx detectó un error al validar el certificado SSL del cliente.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 403, 496, 526 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Nginx Códigos relacionados: 400, 401, 403, 496, 526
496

SSL Certificate Required (Certificado SSL requerido)

Nginx esperaba un certificado SSL de cliente pero no lo recibió.

4xx Error del cliente No estándar No recomendado Nginx
Detalles

496 SSL Certificate Required (Certificado SSL requerido) indica que Nginx esperaba un certificado SSL de cliente pero no lo recibió. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Nginx. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Nginx esperaba un certificado SSL de cliente pero no lo recibió.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Nginx esperaba un certificado SSL de cliente pero no lo recibió.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 403, 495 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Nginx Códigos relacionados: 401, 403, 495
497

HTTP Request Sent to HTTPS Port (HTTP enviado a puerto HTTPS)

Nginx recibió una solicitud HTTP normal en un puerto configurado para HTTPS.

4xx Error del cliente No estándar No recomendado Nginx
Detalles

497 HTTP Request Sent to HTTPS Port (HTTP enviado a puerto HTTPS) indica que Nginx recibió una solicitud HTTP normal en un puerto configurado para HTTPS. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Nginx. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Nginx recibió una solicitud HTTP normal en un puerto configurado para HTTPS.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Nginx recibió una solicitud HTTP normal en un puerto configurado para HTTPS.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 426, 301 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Nginx Códigos relacionados: 400, 426, 301
498

Invalid Token (Token no válido)

Una implementación no estándar indica que el token enviado no es válido.

4xx Error del cliente No estándar Usar con cuidado Esri ArcGIS
Detalles

498 Invalid Token (Token no válido) indica que una implementación no estándar indica que el token enviado no es válido. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Esri ArcGIS. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando una implementación no estándar indica que el token enviado no es válido.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una implementación no estándar indica que el token enviado no es válido.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 403, 419 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Esri ArcGIS Códigos relacionados: 401, 403, 419
499

Client Closed Request (Solicitud cerrada por el cliente)

El cliente cerró la solicitud antes de que Nginx o el servidor terminara de responder.

4xx Error del cliente No estándar No recomendado Nginx
Detalles

499 Client Closed Request (Solicitud cerrada por el cliente) indica que el cliente cerró la solicitud antes de que Nginx o el servidor terminara de responder. Es una error del lado del cliente; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Nginx. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el cliente cerró la solicitud antes de que Nginx o el servidor terminara de responder.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el cliente cerró la solicitud antes de que Nginx o el servidor terminara de responder.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 408, 460, 504 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Nginx Códigos relacionados: 408, 460, 504

5xx Error del servidor

Fallos del servidor o la puerta de enlace relacionados con errores de aplicación, upstream, proxys, CDN, DNS, TLS, sobrecarga, mantenimiento o timeout.

500

Internal Server Error (Error interno del servidor)

El servidor encontró un error inesperado y no pudo completar la solicitud.

5xx Error del servidor Estándar Recomendado RFC 9110
Detalles

500 Internal Server Error (Error interno del servidor) indica que el servidor encontró un error inesperado y no pudo completar la solicitud. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el servidor encontró un error inesperado y no pudo completar la solicitud.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor encontró un error inesperado y no pudo completar la solicitud.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 502, 503, 504, 400, 422 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 502, 503, 504
501

Not Implemented (No implementado)

El servidor no implementa la funcionalidad necesaria para atender el método o característica solicitada.

5xx Error del servidor Estándar Recomendado RFC 9110
Detalles

501 Not Implemented (No implementado) indica que el servidor no implementa la funcionalidad necesaria para atender el método o característica solicitada. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el servidor no implementa la funcionalidad necesaria para atender el método o característica solicitada.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor no implementa la funcionalidad necesaria para atender el método o característica solicitada.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 405, 426, 505 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 405, 426, 505
502

Bad Gateway (Puerta de enlace incorrecta)

Una puerta de enlace o proxy recibió una respuesta inválida del servidor upstream.

5xx Error del servidor Estándar Recomendado RFC 9110
Detalles

502 Bad Gateway (Puerta de enlace incorrecta) indica que una puerta de enlace o proxy recibió una respuesta inválida del servidor upstream. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando una puerta de enlace o proxy recibió una respuesta inválida del servidor upstream.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una puerta de enlace o proxy recibió una respuesta inválida del servidor upstream.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 500, 503, 504, 521, 522 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 500, 503, 504, 521, 522
503

Service Unavailable (Servicio no disponible)

El servicio no está disponible temporalmente por mantenimiento, sobrecarga o falta de capacidad.

5xx Error del servidor Estándar Recomendado RFC 9110
Detalles

503 Service Unavailable (Servicio no disponible) indica que el servicio no está disponible temporalmente por mantenimiento, sobrecarga o falta de capacidad. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando el servicio no está disponible temporalmente por mantenimiento, sobrecarga o falta de capacidad.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servicio no está disponible temporalmente por mantenimiento, sobrecarga o falta de capacidad.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 500, 502, 504, 429 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 500, 502, 504, 429
504

Gateway Timeout (Tiempo de puerta de enlace agotado)

Una puerta de enlace o proxy agotó el tiempo esperando respuesta del servidor upstream.

5xx Error del servidor Estándar Recomendado RFC 9110
Detalles

504 Gateway Timeout (Tiempo de puerta de enlace agotado) indica que una puerta de enlace o proxy agotó el tiempo esperando respuesta del servidor upstream. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Puede documentarse como parte estable de una API pública cuando la semántica encaje.

Situaciones comunes
  • Aparece cuando una puerta de enlace o proxy agotó el tiempo esperando respuesta del servidor upstream.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una puerta de enlace o proxy agotó el tiempo esperando respuesta del servidor upstream.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 408, 502, 503, 524 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 408, 502, 503, 524
505

HTTP Version Not Supported (Versión HTTP no admitida)

El servidor no admite la versión de HTTP usada en la solicitud.

5xx Error del servidor Estándar Usar con cuidado RFC 9110
Detalles

505 HTTP Version Not Supported (Versión HTTP no admitida) indica que el servidor no admite la versión de HTTP usada en la solicitud. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 9110. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor no admite la versión de HTTP usada en la solicitud.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor no admite la versión de HTTP usada en la solicitud.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 426, 501 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 9110 Códigos relacionados: 400, 426, 501
506

Variant Also Negotiates (La variante también negocia)

La negociación transparente de contenido produjo una configuración circular o inválida.

5xx Error del servidor Estándar No recomendado RFC 2295
Detalles

506 Variant Also Negotiates (La variante también negocia) indica que la negociación transparente de contenido produjo una configuración circular o inválida. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 2295. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando la negociación transparente de contenido produjo una configuración circular o inválida.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la negociación transparente de contenido produjo una configuración circular o inválida.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 300, 500 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 2295 Códigos relacionados: 300, 500
507

Insufficient Storage (Almacenamiento insuficiente)

El servidor no tiene almacenamiento suficiente para completar la operación.

5xx Error del servidor Estándar Usar con cuidado RFC 4918
Detalles

507 Insufficient Storage (Almacenamiento insuficiente) indica que el servidor no tiene almacenamiento suficiente para completar la operación. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 4918. Es un código estándar o ampliamente reconocido dentro de HTTP. Conviene usarlo con cuidado y explicar el contexto porque no todos los clientes lo interpretan igual.

Situaciones comunes
  • Aparece cuando el servidor no tiene almacenamiento suficiente para completar la operación.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el servidor no tiene almacenamiento suficiente para completar la operación.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 413, 423, 500 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 4918 Códigos relacionados: 413, 423, 500
508

Loop Detected (Bucle detectado)

WebDAV detectó un bucle infinito al procesar una operación sobre recursos.

5xx Error del servidor Estándar No recomendado RFC 5842
Detalles

508 Loop Detected (Bucle detectado) indica que WebDAV detectó un bucle infinito al procesar una operación sobre recursos. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 5842. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando WebDAV detectó un bucle infinito al procesar una operación sobre recursos.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que WebDAV detectó un bucle infinito al procesar una operación sobre recursos.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 207, 208, 500 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 5842 Códigos relacionados: 207, 208, 500
509

Bandwidth Limit Exceeded (Límite de ancho de banda excedido)

Una implementación de hosting indica que se excedió el límite de ancho de banda.

5xx Error del servidor No estándar No recomendado Apache/cPanel hosting convention
Detalles

509 Bandwidth Limit Exceeded (Límite de ancho de banda excedido) indica que una implementación de hosting indica que se excedió el límite de ancho de banda. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Apache/cPanel hosting convention. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una implementación de hosting indica que se excedió el límite de ancho de banda.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una implementación de hosting indica que se excedió el límite de ancho de banda.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 429, 503, 507 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Apache/cPanel hosting convention Códigos relacionados: 429, 503, 507
510

Not Extended (No extendido)

La solicitud necesita extensiones adicionales que el servidor requiere para procesarla.

5xx Error del servidor Obsoleto No recomendado RFC 2774
Detalles

510 Not Extended (No extendido) indica que la solicitud necesita extensiones adicionales que el servidor requiere para procesarla. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 2774. Está obsoleto y debe evitarse en diseños nuevos. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando la solicitud necesita extensiones adicionales que el servidor requiere para procesarla.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que la solicitud necesita extensiones adicionales que el servidor requiere para procesarla.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 400, 501 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 2774 Códigos relacionados: 400, 501
511

Network Authentication Required (Autenticación de red requerida)

El cliente debe autenticarse en la red, por ejemplo mediante un portal cautivo.

5xx Error del servidor Estándar No recomendado RFC 6585
Detalles

511 Network Authentication Required (Autenticación de red requerida) indica que el cliente debe autenticarse en la red, por ejemplo mediante un portal cautivo. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es RFC 6585. Es un código estándar o ampliamente reconocido dentro de HTTP. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando el cliente debe autenticarse en la red, por ejemplo mediante un portal cautivo.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
  • Paneles operativos, informes de rastreo, Network del navegador y logs de servidor pueden mostrar este código con distintos niveles de contexto.
Qué revisar
  • Confirma primero que el código realmente corresponde a que el cliente debe autenticarse en la red, por ejemplo mediante un portal cautivo.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 407, 403 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: RFC 6585 Códigos relacionados: 401, 407, 403
520

Web Server Returned an Unknown Error (Error desconocido del servidor web)

Cloudflare recibió un error desconocido o inesperado desde el servidor de origen.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

520 Web Server Returned an Unknown Error (Error desconocido del servidor web) indica que Cloudflare recibió un error desconocido o inesperado desde el servidor de origen. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare recibió un error desconocido o inesperado desde el servidor de origen.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare recibió un error desconocido o inesperado desde el servidor de origen.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 500, 502, 521, 522 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 500, 502, 521, 522
521

Web Server Is Down (Servidor web caído)

Cloudflare no pudo conectar porque el servidor de origen está caído o rechaza conexiones.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

521 Web Server Is Down (Servidor web caído) indica que Cloudflare no pudo conectar porque el servidor de origen está caído o rechaza conexiones. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare no pudo conectar porque el servidor de origen está caído o rechaza conexiones.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare no pudo conectar porque el servidor de origen está caído o rechaza conexiones.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 502, 503, 522, 523 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 502, 503, 522, 523
522

Connection Timed Out (Conexión agotada)

Cloudflare agotó el tiempo al intentar establecer conexión con el servidor de origen.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

522 Connection Timed Out (Conexión agotada) indica que Cloudflare agotó el tiempo al intentar establecer conexión con el servidor de origen. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare agotó el tiempo al intentar establecer conexión con el servidor de origen.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare agotó el tiempo al intentar establecer conexión con el servidor de origen.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 502, 504, 521, 524 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 502, 504, 521, 524
523

Origin Is Unreachable (Origen inaccesible)

Cloudflare no puede alcanzar el servidor de origen por DNS, ruta o conectividad.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

523 Origin Is Unreachable (Origen inaccesible) indica que Cloudflare no puede alcanzar el servidor de origen por DNS, ruta o conectividad. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare no puede alcanzar el servidor de origen por DNS, ruta o conectividad.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare no puede alcanzar el servidor de origen por DNS, ruta o conectividad.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 502, 521, 522, 530 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 502, 521, 522, 530
524

A Timeout Occurred (Se produjo un tiempo de espera)

Cloudflare conectó con el origen pero la respuesta tardó demasiado.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

524 A Timeout Occurred (Se produjo un tiempo de espera) indica que Cloudflare conectó con el origen pero la respuesta tardó demasiado. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare conectó con el origen pero la respuesta tardó demasiado.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare conectó con el origen pero la respuesta tardó demasiado.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 504, 522, 503, 202 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 504, 522, 503
525

SSL Handshake Failed (Falló el handshake SSL)

Cloudflare no pudo completar el handshake SSL o TLS con el servidor de origen.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

525 SSL Handshake Failed (Falló el handshake SSL) indica que Cloudflare no pudo completar el handshake SSL o TLS con el servidor de origen. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare no pudo completar el handshake SSL o TLS con el servidor de origen.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare no pudo completar el handshake SSL o TLS con el servidor de origen.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 502, 526, 495 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 502, 526, 495
526

Invalid SSL Certificate (Certificado SSL no válido)

Cloudflare rechazó el certificado SSL del origen por no ser válido.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

526 Invalid SSL Certificate (Certificado SSL no válido) indica que Cloudflare rechazó el certificado SSL del origen por no ser válido. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare rechazó el certificado SSL del origen por no ser válido.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare rechazó el certificado SSL del origen por no ser válido.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 525, 495, 403 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 525, 495, 403
527

Railgun Error (Error de Railgun)

Cloudflare Railgun encontró un error al comunicarse con el origen.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

527 Railgun Error (Error de Railgun) indica que Cloudflare Railgun encontró un error al comunicarse con el origen. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare Railgun encontró un error al comunicarse con el origen.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare Railgun encontró un error al comunicarse con el origen.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 502, 523, 524 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 502, 523, 524
530

Origin DNS Error (Error DNS del origen)

Cloudflare o un proveedor similar informa un error DNS relacionado con el origen.

5xx Error del servidor No estándar No recomendado Cloudflare
Detalles

530 Origin DNS Error (Error DNS del origen) indica que Cloudflare o un proveedor similar informa un error DNS relacionado con el origen. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Cloudflare. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando Cloudflare o un proveedor similar informa un error DNS relacionado con el origen.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que Cloudflare o un proveedor similar informa un error DNS relacionado con el origen.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 523, 521, 522 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Cloudflare Códigos relacionados: 523, 521, 522
561

Unauthorized (No autorizado)

AWS Elastic Load Balancing usa este código para indicar autorización fallida en ciertos flujos.

5xx Error del servidor No estándar No recomendado AWS Elastic Load Balancing
Detalles

561 Unauthorized (No autorizado) indica que AWS Elastic Load Balancing usa este código para indicar autorización fallida en ciertos flujos. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es AWS Elastic Load Balancing. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando AWS Elastic Load Balancing usa este código para indicar autorización fallida en ciertos flujos.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que AWS Elastic Load Balancing usa este código para indicar autorización fallida en ciertos flujos.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 401, 403, 511 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: AWS Elastic Load Balancing Códigos relacionados: 401, 403, 511
598

Network Read Timeout Error (Tiempo de lectura de red agotado)

Una implementación no estándar indica agotamiento del tiempo de lectura de red.

5xx Error del servidor No estándar No recomendado Proxy / Gateway convention
Detalles

598 Network Read Timeout Error (Tiempo de lectura de red agotado) indica que una implementación no estándar indica agotamiento del tiempo de lectura de red. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Proxy / Gateway convention. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una implementación no estándar indica agotamiento del tiempo de lectura de red.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una implementación no estándar indica agotamiento del tiempo de lectura de red.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 504, 524, 599 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Proxy / Gateway convention Códigos relacionados: 504, 524, 599
599

Network Connect Timeout Error (Tiempo de conexión de red agotado)

Una implementación no estándar indica agotamiento del tiempo al conectar con la red.

5xx Error del servidor No estándar No recomendado Proxy / Gateway convention
Detalles

599 Network Connect Timeout Error (Tiempo de conexión de red agotado) indica que una implementación no estándar indica agotamiento del tiempo al conectar con la red. Es una error del servidor, proxy o puerta de enlace; por eso debe interpretarse junto con el método, la ruta, las cabeceras, el cuerpo de respuesta y los registros de la capa que lo generó. La fuente indicada es Proxy / Gateway convention. Es no estándar, de proveedor o de implementación, por lo que no es portable entre plataformas. No conviene convertirlo en contrato principal de una API pública salvo que el caso lo justifique claramente.

Situaciones comunes
  • Aparece cuando una implementación no estándar indica agotamiento del tiempo al conectar con la red.
  • Puede verse en respuestas de API, navegación del navegador, proxys, CDN, balanceadores o registros del servidor relacionados con esta condición.
  • Ayuda a distinguir si el problema nace en el cliente, la aplicación, la puerta de enlace, la caché, el origen o un servicio upstream.
  • El mismo número puede venir de la aplicación, un proxy inverso, una CDN, un balanceador o un servicio upstream, así que conviene confirmar qué capa lo generó.
  • Sirve para comparar respuestas cercanas antes de cambiar un contrato de API, mapeo de SDK, regla de reintento o página de error pública.
Qué revisar
  • Confirma primero que el código realmente corresponde a que una implementación no estándar indica agotamiento del tiempo al conectar con la red.
  • Revisa método, URL, cabeceras, autenticación, permisos, cuerpo de respuesta y mensajes estructurados antes de cambiar el contrato de la API.
  • Comprueba si la respuesta salió de la aplicación, un proxy, una CDN, un balanceador, el servidor de origen o una dependencia upstream.
  • Consulta logs de aplicación, acceso, errores, gateway y traceId para no diagnosticar solo a partir de la página de error del navegador.
  • Compara con 502, 522, 598 antes de sustituirlo por otro estado, especialmente en documentación pública o SDKs.
  • Si el cliente puede recuperarse, devuelve una respuesta con detalle claro, identificador de traza y, cuando proceda, una indicación de reintento.
Evitar usarlo cuando
  • No lo uses para ocultar una condición distinta que debería expresarse con otro código más preciso.
  • No lo conviertas en contrato público si en realidad procede de infraestructura, proveedor o comportamiento interno no portable.
  • No lo trates como éxito general ni como fallo genérico sin revisar la semántica específica del código.
Fuente: Proxy / Gateway convention Códigos relacionados: 502, 522, 598

Resumen

La página está pensada para depuración diaria de API y revisión de incidentes, no solo para memorizar números. Cada entrada combina significado de protocolo y contexto operativo para frontend, backend, QA, SRE, auditorías SEO y documentación de API.

  1. 01

    Códigos estándar y extendidos

    Incluye códigos definidos por RFC y códigos de extensión o proveedor vistos en WebDAV, Nginx, Cloudflare, balanceadores AWS, convenciones Microsoft/IIS, puertas de enlace proxy y borradores de subida reanudable.

  2. 02

    Contexto de diagnóstico buscable

    La búsqueda cubre número, frase, categoría, resumen, fuente, códigos relacionados, situaciones comunes, revisiones y notas de uso, para localizar entradas con términos como caché, CORS, timeout, WebSocket o límite de frecuencia.

  3. 03

    Recomendaciones para diseño de API

    Cada código incluye un nivel de recomendación que separa lo adecuado para REST API o JSON API públicas de lo que conviene dejar como detalle interno, de proveedor o de infraestructura.

  4. 04

    Impacto operativo y SEO

    Redirecciones, errores blandos, 404/410 visibles para crawlers, fallos de gateway, límites 429 e interrupciones 5xx se explican con foco en páginas de usuario y clientes automatizados.

Cómo usarla

Úsala mientras revisas DevTools del navegador, logs del servidor, respuestas de API, paneles CDN, logs del balanceador, informes de rastreo o alertas de monitorización.

  1. 01

    Busca el número, la frase, el proveedor o el síntoma que aparece en los logs o herramientas de red.

  2. 02

    Usa los filtros de clase cuando ya sepas si la respuesta es informativa, correcta, redirigida, de cliente o de servidor.

  3. 03

    Abre la entrada coincidente y lee primero el resumen; después revisa situaciones comunes para identificar la capa que probablemente generó la respuesta.

  4. 04

    Compara códigos relacionados antes de cambiar un contrato de API; muchos errores vienen de mezclar 200, 400, 401, 403, 404, 409, 422, 429, 500, 502, 503 y 504.

  5. 05

    Usa fuente y ciclo de vida para decidir si el código es suficientemente portable para documentación pública o si debe quedar como detalle de infraestructura.

Detalles

Las entradas están estructuradas para lectura rápida durante depuración real y con detalle suficiente para documentación de API y notas internas de ingeniería.

  • Número oficial, frase y clase de estado.
  • Resumen breve para consulta rápida y explicación ampliada para diagnóstico.
  • Situaciones donde el código aparece en API, navegadores, CDN, gateways, proxys y logs de servidor.
  • Revisiones concretas para solicitudes de cliente, backend, rutas, autenticación, caché, redirecciones e infraestructura.
  • Notas sobre usos que conviene evitar para no dar una semántica engañosa.
  • Códigos relacionados para comparar antes de cambiar el comportamiento de una implementación.
  • Ciclo de vida y fuente para distinguir códigos estándar, obsoletos, temporales, de proveedor o específicos de implementación.

Casos de uso

Esta página ayuda cuando un código aparece en una respuesta, línea de log, informe SEO, alerta de disponibilidad, prueba de API, error de SDK o panel de proxy inverso.

  1. Diseño de REST API y JSON API

    Elige el estado correcto para creación, actualización, validación, autenticación, autorización, conflicto, límite de frecuencia, trabajo asíncrono y respuestas sin cuerpo.

  2. Depuración frontend y navegador

    Entiende redirecciones, fallos parecidos a CORS, retos de autenticación, precondiciones, revalidación de caché, upgrades WebSocket y cargas de recursos fallidas desde Network.

  3. SEO y diagnóstico de rastreo

    Revisa 301, 302, 307, 308, 404, 410, 429, 500, 503, errores blandos, cadenas de redirección, páginas no disponibles y errores de servidor visibles para crawlers.

  4. Incidentes de CDN, gateway y balanceador

    Separa errores del origen frente a Cloudflare, Nginx, AWS ALB, timeout de proxy, TLS, DNS y alcance upstream antes de tocar código de aplicación.

Ver también

Cuando un error HTTP implica un puerto de servicio, regla de firewall o ruta de entrada, usa Referencia de puertos para consultar servicio, protocolo y exposición recomendada. Si el problema está en la estructura de la URL, parámetros o codificación, Herramientas de URL permite analizar e inspeccionar el enlace completo.

Buenas prácticas

Un estado HTTP debe describir con claridad el resultado a nivel de protocolo. El cuerpo puede añadir códigos de aplicación, mensajes por campo, traceId, consejos de reintento y enlaces de ayuda.

  • No devuelvas 200 para errores de aplicación solo porque el servidor pudo producir un JSON.
  • Usa 201 para recursos creados, 202 para trabajos asíncronos aceptados y 204 cuando la operación tuvo éxito pero no hay cuerpo de respuesta.
  • Usa 400 para solicitudes mal formadas, 401 para autenticación ausente o inválida, 403 para acceso autenticado pero prohibido, 404 para no encontrado, 409 para conflictos de estado y 422 para entrada semánticamente inválida cuando esa distinción aporte valor.
  • Usa 429 para límites de frecuencia e incluye orientación de reintento cuando el cliente pueda esperar y volver a intentar.
  • Evita exponer códigos no estándar de proveedor como contratos públicos salvo que quien llama necesite explícitamente ese detalle de infraestructura.
  • En sitios públicos, asegúrate de que las páginas de error devuelvan el estado correcto para que los buscadores no indexen soft 404 ni páginas de caída temporal como contenido normal.

Limitaciones

Los códigos HTTP son señales de protocolo estandarizadas, pero la causa exacta depende de ruta, método, cabeceras, cuerpo de respuesta, caché, cadena de proxys y logs del servidor.

  • Un código por sí solo rara vez demuestra qué servicio generó la respuesta; compara logs de aplicación con CDN, gateway, proxy, balanceador y origen.
  • Algunos códigos de proveedor o implementación son útiles en paneles operativos, pero no son semántica HTTP portable.
  • Navegadores, clientes API, crawlers y SDK pueden manejar redirecciones, retos de autenticación, caché y respuestas provisionales de forma distinta.
  • Para comportamiento final de API, documenta tanto el estado HTTP como el cuerpo estructurado para que los clientes tomen decisiones estables.

Preguntas frecuentes

Respuestas a dudas comunes sobre uso, tratamiento de datos, comprobación de resultados y límites prácticos.

¿Cuál es la diferencia entre 401 y 403?

401 significa que la solicitud carece de autenticación válida o necesita un reto de autenticación. 403 significa que el servidor entendió la solicitud, y normalmente al llamador, pero rechaza la acción porque no tiene permiso para ese recurso.

¿Una API debe devolver 400 o 422 para errores de validación?

Usa 400 cuando la solicitud está mal formada o no puede analizarse. Usa 422 cuando la sintaxis es válida pero los valores enviados fallan una validación de negocio o semántica. Lo importante es documentar una convención coherente.

¿Cuándo debe un sitio usar 404 frente a 410?

Usa 404 cuando el recurso no se encuentra o no quieres revelar si existe. Usa 410 cuando el recurso se eliminó intencionalmente y se espera que esa condición sea permanente, algo más claro para crawlers y clientes.

¿Por qué veo códigos específicos de Cloudflare, Nginx o AWS?

Esas respuestas pueden generarse en infraestructura antes de que la solicitud llegue a tu aplicación, o después de que el origen falle. Revisa logs de proxy, CDN, gateway, DNS, TLS, firewall y balanceador antes de atribuirlo al código de aplicación.

¿Todos los 5xx son errores de código del servidor?

No siempre. Un 5xx indica fallo del lado servidor durante el intercambio, pero la causa puede ser una dependencia upstream, mantenimiento, sobrecarga, timeout de gateway, DNS, TLS o configuración del proxy inverso.

Herramientas relacionadas

Usa la categoría de referencia cuando la depuración HTTP derive hacia puertos de red, tipos MIME, cabeceras, comportamiento de URL u otros detalles de implementación.