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.
Los problemas de JSON API suelen empezar como bugs frontend vagos: un campo faltante, null inesperado, fecha inválida, tipo incorrecto o un body que ni siquiera es JSON válido.
El flujo más rápido separa problemas de transporte y de datos. Primero revise status HTTP y headers, luego si el body es JSON válido, y después valide la forma contra el contrato esperado.
Formatee e inspeccione el payload
El formato pretty facilita revisar objetos y arrays anidados. También ayuda a ver respuestas truncadas, campos sospechosos o strings que contienen JSON escapado.
Si el payload no parsea, revise trailing commas, comillas inválidas, comments, caracteres de control sin escapar o una página HTML de error devuelta en lugar de JSON.
Valide la forma esperada
Un payload puede ser JSON válido y seguir siendo incorrecto para la app. La validación de schema detecta required fields faltantes, tipos incorrectos, enum inesperados y cambios de estructura.
Cuando el backend cambia un campo de number a string o devuelve null donde la UI espera un object, schema validation suele indicar la diferencia exacta.
Revise status codes y conversiones
No depure el body sin revisar el status HTTP. Un 401, 403, 404, 422 o 500 puede explicar por qué el payload no coincide con el happy path.
Al pasar entre JSON y YAML o archivos de configuración, verifique que arrays, booleanos, nulls y strings quoted mantengan el significado esperado.
Checklist para depurar JSON API
- Revise primero status HTTP, content type y response headers.
- Formatee el JSON antes de inspeccionar datos anidados.
- Valide el payload contra el schema o contrato esperado.
- Busque nulls, campos faltantes, tipos incorrectos y enum values cambiados.
- Confirme que las conversiones preserven booleanos, arrays, nulls y strings.
Guías relacionadas
Aprenda el workflow detrás de esta herramienta y qué revisar después.
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.
Cómo inspeccionar problemas de autenticación JWT
Flujo JWT para revisar claims, time values, permisos y signing assumptions sin tratar decode como verification.