Cómo depurar respuestas JSON de una API
Formatee la respuesta, confirme el estado HTTP, valide el schema y compare cambios del payload antes de modificar código.
Los bugs de respuestas API suelen mezclar dos problemas: el request no envió lo esperado o el body no coincide con lo que espera la aplicación.
Un flujo fiable separa transporte, sintaxis, schema y comparación de cambios para encontrar el fallo sin adivinar.
Empiece por el request
Si el reporte incluye un comando cURL, analícelo primero. Revise método, URL, query parameters, headers, content type y body.
Un Authorization header incorrecto, content type faltante, endpoint antiguo o query parameter cambiado puede producir JSON válido pero equivocado.
Formatee y valide la respuesta
Pretty-print JSON para revisar objetos anidados, arrays, nulls y strings escapados con más claridad.
Después valide contra JSON Schema para detectar campos requeridos faltantes, tipos incorrectos, enums cambiados y estructuras inesperadas.
Compare payloads antes y después
Cuando una API cambia tras un release, compare el JSON anterior y nuevo lado a lado. Busque campos renombrados, wrappers nuevos, arrays eliminados, IDs cambiados y estados distintos.
Normalice el formato primero para que el diff muestre cambios de datos y no whitespace.
Checklist de depuración JSON API
- Analice el cURL copiado y confirme método, URL, headers y body.
- Revise HTTP status y content type antes del body.
- Formatee la respuesta JSON y quite datos privados antes de compartirla.
- Valide el payload contra el schema esperado.
- Compare respuestas antiguas y nuevas cuando un release o proveedor cambia comportamiento.
Guías relacionadas
Aprenda el workflow detrás de esta herramienta y qué revisar después.
Cómo depurar payloads JSON de API
Un workflow práctico para formatear JSON, encontrar errores de sintaxis, validar la forma del payload y revisar el status cuando los datos de API no cuadran.
Cómo inspeccionar problemas de autenticación JWT
Flujo JWT para revisar claims, time values, permisos y signing assumptions sin tratar decode como verification.
Cómo limpiar datos CSV antes de importar
Workflow de CSV cleanup para revisar imported data, deduplicar rows, filtrar records y extraer columnas importantes.