Artigo TechTool
JSON válido em APIs: erros comuns e como corrigir rápido
Payloads quebrados atrasam integrações; validar e formatar JSON reduz retrabalho.
Por que JSON quebra
Os erros mais comuns são vírgula sobrando, aspas simples, chaves sem fechamento, caracteres invisíveis e payload copiado de logs com prefixos ou comentários.
Como depurar melhor
Formate o JSON antes de comparar payloads. A indentação deixa estruturas aninhadas mais claras e ajuda a encontrar arrays, objetos e campos em lugar errado.
Onde usar
Validação de JSON é útil em APIs REST, webhooks, documentação técnica, testes automatizados, integração com ERPs e revisão de exemplos para suporte.
Checklist prático
- ✓ Cole o payload bruto antes de abrir chamado para uma integração.
- ✓ Valide exemplos de documentação antes de publicar.
- ✓ Remova dados sensíveis antes de colar qualquer JSON em ferramenta pública.
Perguntas frequentes
JSON pode ter comentários?
Não no padrão JSON. Comentários são aceitos em alguns formatos derivados, mas payloads de API geralmente devem ser JSON estrito.
Aspas simples funcionam em JSON?
Não. Chaves e strings devem usar aspas duplas.
Formatar JSON altera os dados?
A formatação muda espaços e quebras de linha, mas mantém a estrutura e os valores quando o JSON é válido.