2026-05-31 · Lectura de 2 min
Lista de verificación para la depuración de respuestas HTTP
Una lista de verificación práctica para aislar fallos de API según el código de estado, los encabezados y la estructura de la carga útil.
Conclusiones clave
- Verifique primero el código de estado y el tipo de contenido (Content-Type) antes de leer los detalles del cuerpo de la respuesta.
- Repita la solicitud utilizando los mismos encabezados y parámetros de consulta para evitar falsos positivos.
Flujo rápido de triaje
Comience analizando el código de estado de la respuesta y, a continuación, revise los encabezados de la respuesta. Esto permite distinguir rápidamente entre problemas de autenticación, errores de validación y caídas del servicio remoto.
Para respuestas 4xx, compare los encabezados y la estructura del cuerpo de la solicitud con la documentación de la API antes de reintentarla.
Para respuestas 5xx, conserve los identificadores de solicitud (request IDs) y las marcas de tiempo para poder correlacionarlas con los registros del servidor.
Mantenga las solicitudes reproducibles
Guarde exactamente la URL, la cadena de consulta, el modo de autenticación y el cuerpo utilizados durante la depuración.
Si su solicitud incluye campos dinámicos (como marcas de tiempo o valores aleatorios), fije los datos de prueba para reducir el ruido.
Clasificar códigos HTTP en producción
4xx: valida autenticación, rutas y cuerpo antes de tocar el servidor—muchas veces el contrato OpenAPI no coincide con el payload real.
5xx: captura correlation-id, hora UTC y tamaño del cuerpo; repite la misma petición con HTTP Request importando cURL para comparar headers.
3xx: confirma si el cliente sigue redirecciones y si se pierden cookies de sesión entre saltos http→https.
Preguntas frecuentes
¿Por qué sigo recibiendo un error 401 después de agregar un token?
Revise cuidadosamente el formato del encabezado Authorization y compruebe si el servicio remoto espera tokens Bearer, Basic o cookies firmadas.
¿Qué debo inspeccionar ante errores 415 o 422?
Verifique el tipo de contenido (Content-Type) y el esquema de la carga útil. Valide el JSON localmente antes de enviar la solicitud.