Referencia para desarrolladores

Códigos de estado HTTPy pistas para depurar

Busca un número o término, filtra por familia y consulta el ejemplo y su fuente.

códigos de estado HTTP

Número o término

Coincidencias

1xx Información
2xx Éxito
3xx Redirección
4xx Error del cliente
5xx Error del servidor

Respuesta elegida

502 Bad Gateway

5xx Error del servidor

Significado: Una puerta de enlace recibió una respuesta ascendente inválida.

Situación habitual: Falló la conexión o respuesta del servidor ascendente.

Comprueba primero: Revisar proxy y origen; distinguirlo del tiempo agotado 504.

Respuesta HTTP ilustrativa

Ejemplo HTTP/1.1 inventado; las cabeceras y el cuerpo reales pueden ser distintos.

HTTP/1.1 502 Bad Gateway
Content-Type: application/problem+json

{"title":"Bad Gateway","status":502}

La búsqueda filtra datos incluidos en el navegador. Solo al abrir un enlace se accede a una fuente externa.

Familia de respuesta

28 de 28 códigos seleccionados · viendo 502

Registro IANA actualizado por última vez: 15 sep 2025Selección revisada: 23 sep 2026

Un número en el registro de una API no dice por sí solo si falló la petición, la puerta de enlace o el servidor de origen. Esta referencia de códigos de estado HTTP une el significado del protocolo con una respuesta ilustrativa y la primera comprobación.

Usa los códigos de estado HTTP para orientar la investigación y luego revisa las cabeceras, el cuerpo y los registros reales. Esta selección no prueba sitios en vivo ni sustituye el registro completo de IANA.

Por qué consultar estos códigos de estado HTTP

Un número orienta, pero la capa que respondió determina qué revisar después.

Respuesta errónea frente a espera agotada

Entre los códigos de estado HTTP, 502 indica que un intermediario recibió una respuesta ascendente inválida; 504 indica que no llegó a tiempo. La investigación empieza en puntos distintos.

Dos rutas de puerta de enlace: una recibe una respuesta rota y la otra espera hasta que vence un reloj

Del resultado a la evidencia

La ficha 429 muestra Retry-After y una comprobación inicial. Cada entrada enlaza también el RFC que la define y el registro IANA.

Una búsqueda reduce varias fichas a una respuesta con un reloj de reintento y una lista de comprobación

Interpretar la señal antes de actuar

01

Buscar número o significado

Sin consulta se ven las 28 entradas. Puedes buscar número, nombre inglés o sentido en español; las cinco familias filtran la búsqueda ya enviada.

02

Comparar códigos próximos

502 y 504 distinguen una respuesta ascendente inválida de un tiempo agotado. El ejemplo 429 muestra Retry-After; 302 y 307 tratan de forma distinta el método.

03

Confirmar con la petición real

Los fragmentos HTTP/1.1 son inventados. Abre el RFC y revisa cabeceras y registros reales; un código no encontrado quizá solo queda fuera de la selección.

Información reunida en cada ficha

Cinco familias con búsqueda local

La lista de códigos HTTP reúne 28 entradas de 1xx a 5xx. La búsqueda por número, nombre o significado funciona sin consultas de red.

La forma de respuesta y sus cabeceras

204 y 304 no incluyen cuerpo en los ejemplos; 401, 405 y 429 muestran cabeceras útiles de autenticación, métodos o reintento.

Fuente normativa accesible

Los enlaces RFC e IANA ayudan a separar los códigos de respuesta HTTP de los errores internos de cada aplicación.

Alcance y límites de interpretación

Selección, no inventario completo
Solo hay 28 entradas. Un número propio de un proveedor que no aparezca no es necesariamente inválido. IANA mantiene el registro completo y aquí no hay páginas separadas por código.
Sin diagnóstico en vivo
La búsqueda no solicita ninguna URL ni lee registros. Un 502 por sí solo no identifica si falló la CDN, el proxy o el origen.
Ejemplos ficticios
Los textos representan HTTP/1.1 inventado. HTTP/2, HTTP/3 y las respuestas reales pueden tener otro formato o contenido.
Reintentar depende de la operación
429 y 503 pueden incluir Retry-After, pero repetir una escritura exige revisar la idempotencia y la política del servicio.

Preguntas sobre códigos de estado HTTP

¿En qué grupos se dividen los códigos de estado HTTP?

1xx informa, 2xx señala éxito, 3xx redirige, 4xx corresponde a errores del cliente y 5xx a errores del servidor. Esta referencia de códigos de estado HTTP recoge 28 casos y enlaza el registro completo.

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

401 indica que falta autenticación válida y debe incluir un desafío WWW-Authenticate. Con 403 el servidor entiende la solicitud, pero la rechaza aunque conozca la identidad.

¿Cuándo se usa 410 en vez de 404?

404 dice que no se encontró una representación actual sin afirmar que la ausencia sea permanente. 410 es más preciso si se sabe que el recurso se eliminó definitivamente.

¿Qué hacer ante un 429?

Lee Retry-After si está presente y la política de límites del servicio. Antes de repetir una escritura comprueba que la operación puede reintentarse sin riesgo.

¿En qué se diferencian 502 y 504?

502 significa que la puerta de enlace recibió una respuesta ascendente inválida; 504 que no recibió respuesta a tiempo. Los registros del proxy y del origen muestran la causa concreta.

¿Falta un código o una comprobación?

Consultar códigos de estado HTTP

Busca el número, compara el ejemplo con las cabeceras reales y revisa la definición antes de cambiar el cliente o servidor.