Dominando a Formatação e Validação de JSON

Javascript Object Notation (JSON) é o rei indiscutível das APIs modernas e da transferência de dados. Porém, por ser extremamente rigoroso, uma única vírgula fora do lugar pode derrubar um endpoint inteiro em produção.

Neste guia, vamos abordar as regras de ouro da formatação JSON.

As Regras de Sintaxe do JSON

Ao contrário dos objetos Javascript comuns, o JSON é notoriamente inflexível. Se você quebrar essas regras, o parser lança um SyntaxError.

1. As chaves DEVEM estar entre aspas duplas: 'name': 'John' é inválido. O correto é "name": "John".
2. Sem vírgulas finais: Não é permitido deixar uma vírgula após o último item de um array ou objeto.
3. Sem funções ou undefined: JSON só pode armazenar strings, números, booleanos, arrays, objetos e null.

JSON Válido vs. Inválido

Veja o que o rigoroso parser JSON exige de nós.

{
  "user": {
    "id": 1042,
    "isActive": true,
    "roles": ["admin", "editor"],
    "preferences": null
  }
}

Se tentássemos escrever esse mesmo objeto de forma livre, como fazemos em scripts JS:

// Isso é JSON INVÁLIDO (mas Javascript válido)
{
  user: {
    id: 1042,
    isActive: true, // vírgula final
  }
}

Por Que a Validação é Importante

Ao conectar microsserviços, enviar um JSON inválido faz com que o servidor receptor lance um enorme erro 500, pois o JSON.parse() falha de forma catastrófica. Sempre valide e formate seu JSON antes de adicioná-lo a uma aplicação.

Use uma ferramenta de formatação automatizada para validar que os payloads da sua API estão seguros e com a estrutura correta!

Pronto para testar seus dados? Acesse nosso JSON Formatter & Validator para embelezar suas strings brutas na hora!