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.
No se encontraron códigos de estado HTTP coincidentes.
1xx Informativos
Respuestas provisionales enviadas antes de la respuesta final. Normalmente las gestionan clientes HTTP, servidores, proxys o la capa de red del navegador.
Continue (Continuar)
El servidor recibió las cabeceras y permite que el cliente continúe enviando el cuerpo de la solicitud.
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.
Switching Protocols (Cambio de protocolo)
El servidor aceptó cambiar la conexión al protocolo solicitado, como ocurre en un handshake WebSocket.
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.
Processing (Procesando)
El servidor recibió la solicitud completa y sigue procesándola sin tener aún una respuesta final.
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.
Early Hints (Pistas tempranas)
El servidor envía cabeceras preliminares para que el cliente pueda precargar recursos antes de la respuesta final.
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.
Upload Resumption Supported (Reanudación de subida compatible)
El servidor indica que admite reanudar una subida interrumpida según el borrador de cargas reanudables.
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.
2xx Correctos
Respuestas de éxito. Elegir el código correcto permite distinguir trabajo completado, recursos creados, tareas aceptadas, respuestas sin cuerpo y contenido parcial.
OK (Correcto)
La solicitud se completó correctamente y la respuesta contiene el resultado esperado.
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.
Created (Creado)
La solicitud creó un recurso nuevo y la respuesta debe señalar su ubicación o representación.
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.
Accepted (Aceptado)
La solicitud fue aceptada para procesamiento posterior, pero el trabajo todavía no ha terminado.
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.
Non-Authoritative Information (Información no autorizada)
La respuesta correcta fue transformada por un intermediario y no es exactamente la representación original.
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.
No Content (Sin contenido)
La operación se completó correctamente pero no hay cuerpo de respuesta que devolver.
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.
Reset Content (Restablecer contenido)
La operación se completó y el cliente debería restablecer la vista o formulario que originó la solicitud.
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.
Partial Content (Contenido parcial)
El servidor devuelve solo una parte del recurso solicitada mediante cabeceras Range.
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.
Multi-Status (Estado múltiple)
Una respuesta WebDAV incluye varios resultados independientes dentro de un mismo cuerpo.
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.
Already Reported (Ya informado)
WebDAV evita repetir miembros de una colección que ya fueron informados en la misma respuesta.
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.
IM Used (IM usado)
El servidor aplicó una manipulación de instancia y devuelve el resultado de esa representación.
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.
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.
Multiple Choices (Varias opciones)
Existen varias representaciones posibles y el cliente o usuario debe elegir una.
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.
Moved Permanently (Movido permanentemente)
El recurso se movió permanentemente a otra URL y los clientes deberían actualizar sus enlaces.
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.
Found (Encontrado)
El recurso se encuentra temporalmente en otra URL, aunque la semántica histórica puede cambiar el método.
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.
See Other (Ver otro)
El cliente debe consultar otra URL con GET para obtener el resultado de una operación.
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.
Not Modified (No modificado)
La representación en caché del cliente sigue siendo válida y no hace falta descargar el cuerpo de nuevo.
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.
Use Proxy (Usar proxy)
El acceso debía realizarse mediante un proxy indicado por el servidor, un comportamiento obsoleto.
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.
Unused (Sin uso)
El código está reservado por compatibilidad histórica y no tiene uso operativo actual.
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.
Temporary Redirect (Redirección temporal)
El recurso se redirige temporalmente a otra URL conservando el método y el cuerpo original.
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.
Permanent Redirect (Redirección permanente)
El recurso se redirige permanentemente a otra URL conservando el método y el cuerpo original.
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.
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.
Bad Request (Solicitud incorrecta)
La solicitud es inválida o no puede analizarse correctamente por sintaxis, formato o parámetros básicos.
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.
Unauthorized (No autenticado)
La solicitud no incluye autenticación válida o necesita completar un reto de autenticación.
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.
Payment Required (Pago requerido)
El código está reservado para pagos y rara vez tiene una semántica interoperable en HTTP público.
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.
Forbidden (Prohibido)
El servidor entiende la solicitud pero rechaza ejecutarla por permisos o políticas de acceso.
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.
Not Found (No encontrado)
El recurso solicitado no se encontró o el servidor no quiere revelar si existe.
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.
Method Not Allowed (Método no permitido)
El método HTTP usado no está permitido para ese recurso aunque la ruta exista.
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.
Not Acceptable (No aceptable)
El servidor no puede producir una representación aceptable según las cabeceras de negociación del cliente.
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.
Proxy Authentication Required (Autenticación de proxy requerida)
La solicitud debe autenticarse ante un proxy antes de poder continuar.
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.
Request Timeout (Tiempo de solicitud agotado)
El servidor cerró la solicitud porque el cliente tardó demasiado en enviarla.
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.
Conflict (Conflicto)
La solicitud entra en conflicto con el estado actual del recurso o del flujo de negocio.
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.
Gone (Eliminado)
El recurso existió pero fue eliminado de forma permanente y no se espera que vuelva.
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.
Length Required (Longitud requerida)
El servidor exige Content-Length para procesar correctamente la solicitud.
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.
Precondition Failed (Precondición fallida)
Una precondición como If-Match o If-Unmodified-Since no se cumple.
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.
Content Too Large (Contenido demasiado grande)
El cuerpo o contenido enviado es mayor de lo que el servidor está dispuesto a aceptar.
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.
URI Too Long (URI demasiado larga)
La URI de la solicitud es demasiado larga para que el servidor la procese.
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.
Unsupported Media Type (Tipo de medio no admitido)
El tipo de medio o formato del cuerpo no es compatible con el endpoint.
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.
Range Not Satisfiable (Rango no satisfacible)
El rango solicitado no puede satisfacerse para el recurso actual.
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.
Expectation Failed (Expectativa fallida)
El servidor no puede cumplir la expectativa indicada por la cabecera Expect.
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.
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.
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.
Page Expired (Página caducada)
Una sesión, token CSRF o estado de página caducó según una convención de framework.
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.
Enhance Your Calm (Reduce la frecuencia)
Una implementación no estándar pide reducir la frecuencia o calmar el volumen de solicitudes.
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.
Misdirected Request (Solicitud mal dirigida)
La solicitud llegó a un servidor que no está autorizado o configurado para responder por ese origen.
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.
Unprocessable Content (Contenido no procesable)
La sintaxis de la solicitud es válida pero sus valores no pasan la validación semántica.
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.
Locked (Bloqueado)
El recurso está bloqueado, normalmente en un flujo WebDAV o de edición concurrente.
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.
Failed Dependency (Dependencia fallida)
La operación falla porque dependía de otra acción que también falló.
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.
Too Early (Demasiado pronto)
El servidor no quiere procesar la solicitud porque podría repetirse de forma insegura demasiado pronto.
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.
Upgrade Required (Actualización requerida)
El servidor exige que el cliente use una versión o protocolo diferente para continuar.
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.
Precondition Required (Precondición requerida)
El servidor requiere precondiciones para evitar actualizaciones perdidas o escrituras concurrentes inseguras.
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.
Too Many Requests (Demasiadas solicitudes)
El cliente superó un límite de frecuencia, cuota o volumen de solicitudes.
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.
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.
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.
Request Header Fields Too Large (Campos de cabecera demasiado grandes)
Uno o varios campos de cabecera de la solicitud son demasiado grandes.
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.
Login Timeout (Sesión de inicio caducada)
Una convención de Microsoft IIS indica que la sesión de inicio de sesión expiró.
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.
No Response (Sin respuesta)
Nginx cerró la conexión sin enviar respuesta HTTP al cliente.
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.
Retry With (Reintentar con datos adicionales)
Una convención de Microsoft indica que la solicitud debe reintentarse con información adicional.
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.
Blocked by Windows Parental Controls (Bloqueado por control parental)
Una convención antigua de Microsoft indica bloqueo por controles parentales de Windows.
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.
Unavailable For Legal Reasons (No disponible por razones legales)
El recurso no está disponible por una restricción legal, orden o política aplicable.
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.
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.
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.
Too Many Forwarded IPs (Demasiadas IP reenviadas)
AWS o un intermediario recibió demasiadas IP en cabeceras de reenvío.
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.
Incompatible Protocol (Protocolo incompatible)
AWS o un intermediario detectó una incompatibilidad de protocolo o puerto entre cliente y destino.
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.
Request Header Too Large (Cabecera de solicitud demasiado grande)
Nginx rechazó la solicitud porque la cabecera era demasiado grande.
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.
SSL Certificate Error (Error de certificado SSL)
Nginx detectó un error al validar el certificado SSL del cliente.
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.
SSL Certificate Required (Certificado SSL requerido)
Nginx esperaba un certificado SSL de cliente pero no lo recibió.
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.
HTTP Request Sent to HTTPS Port (HTTP enviado a puerto HTTPS)
Nginx recibió una solicitud HTTP normal en un puerto configurado para HTTPS.
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.
Invalid Token (Token no válido)
Una implementación no estándar indica que el token enviado no es válido.
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.
Client Closed Request (Solicitud cerrada por el cliente)
El cliente cerró la solicitud antes de que Nginx o el servidor terminara de responder.
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.
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.
Internal Server Error (Error interno del servidor)
El servidor encontró un error inesperado y no pudo completar la solicitud.
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.
Not Implemented (No implementado)
El servidor no implementa la funcionalidad necesaria para atender el método o característica solicitada.
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.
Bad Gateway (Puerta de enlace incorrecta)
Una puerta de enlace o proxy recibió una respuesta inválida del servidor upstream.
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.
Service Unavailable (Servicio no disponible)
El servicio no está disponible temporalmente por mantenimiento, sobrecarga o falta de capacidad.
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.
Gateway Timeout (Tiempo de puerta de enlace agotado)
Una puerta de enlace o proxy agotó el tiempo esperando respuesta del servidor upstream.
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.
HTTP Version Not Supported (Versión HTTP no admitida)
El servidor no admite la versión de HTTP usada en la solicitud.
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.
Variant Also Negotiates (La variante también negocia)
La negociación transparente de contenido produjo una configuración circular o inválida.
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.
Insufficient Storage (Almacenamiento insuficiente)
El servidor no tiene almacenamiento suficiente para completar la operación.
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.
Loop Detected (Bucle detectado)
WebDAV detectó un bucle infinito al procesar una operación sobre recursos.
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.
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.
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.
Not Extended (No extendido)
La solicitud necesita extensiones adicionales que el servidor requiere para procesarla.
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.
Network Authentication Required (Autenticación de red requerida)
El cliente debe autenticarse en la red, por ejemplo mediante un portal cautivo.
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.
Web Server Returned an Unknown Error (Error desconocido del servidor web)
Cloudflare recibió un error desconocido o inesperado desde el servidor de origen.
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.
Web Server Is Down (Servidor web caído)
Cloudflare no pudo conectar porque el servidor de origen está caído o rechaza conexiones.
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.
Connection Timed Out (Conexión agotada)
Cloudflare agotó el tiempo al intentar establecer conexión con el servidor de origen.
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.
Origin Is Unreachable (Origen inaccesible)
Cloudflare no puede alcanzar el servidor de origen por DNS, ruta o conectividad.
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.
A Timeout Occurred (Se produjo un tiempo de espera)
Cloudflare conectó con el origen pero la respuesta tardó demasiado.
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.
SSL Handshake Failed (Falló el handshake SSL)
Cloudflare no pudo completar el handshake SSL o TLS con el servidor de origen.
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.
Invalid SSL Certificate (Certificado SSL no válido)
Cloudflare rechazó el certificado SSL del origen por no ser válido.
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.
Railgun Error (Error de Railgun)
Cloudflare Railgun encontró un error al comunicarse con el origen.
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.
Origin DNS Error (Error DNS del origen)
Cloudflare o un proveedor similar informa un error DNS relacionado con el origen.
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.
Unauthorized (No autorizado)
AWS Elastic Load Balancing usa este código para indicar autorización fallida en ciertos flujos.
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.
Network Read Timeout Error (Tiempo de lectura de red agotado)
Una implementación no estándar indica agotamiento del tiempo de lectura de red.
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.
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.
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.
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.
- 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.
- 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.
- 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.
- 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.
- 01
Busca el número, la frase, el proveedor o el síntoma que aparece en los logs o herramientas de red.
- 02
Usa los filtros de clase cuando ya sepas si la respuesta es informativa, correcta, redirigida, de cliente o de servidor.
- 03
Abre la entrada coincidente y lee primero el resumen; después revisa situaciones comunes para identificar la capa que probablemente generó la respuesta.
- 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.
- 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.
-
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.
-
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.
-
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.
-
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.