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 paso a paso una respuesta JSON de API
Un proceso repetible para separar errores de transporte, problemas de sintaxis JSON y fallos del contrato de datos en las respuestas de una API.
Cómo depurar autenticación JWT de forma segura
Un proceso orientado a la seguridad para separar la estructura del token, la validación de declaraciones, la verificación de la firma y las decisiones de autorización.