Guia Json para Automação

JSON (JavaScript Object Notation) é um formato de texto estruturado usado para enviar e receber dados em APIs. Ele é simples, mas extremamente rígido, e erros pequenos podem invalidar todo o body de uma requisição.

A seguir, um guia completo incluindo tudo que pode e não pode ser feito.

✅ 1. ESTRUTURA BÁSICA DE UM JSON

Um JSON é formado por:

• Objetos { }
• Arrays [ ]
• Pares chave:valor separados por vírgula

Exemplo válido:

{
  "nome": "João",
  "idade": 30
}

✅ 2. ASPAS (“) — UM DOS MAIORES MOTIVOS DE ERRO

✔ JSON exige:

• Chaves (keys) com aspas duplas " "
• Strings com aspas duplas " "

❌ Não permitido:

• Aspas simples ' '
• Chaves sem aspas
• Strings sem aspas

Exemplo errado:

{ nome: 'João' }

Exemplo correto:

{ "nome": "João" }

✅ 3. VÍRGULAS (,) — ATENÇÃO AO FINAL

A vírgula separa pares chave:valor.

✔ Corretamente:

{
  "a": 1,
  "b": 2
}

❌ Erros comuns:

• Vírgula sobrando no último item

{
  "a": 1,
  "b": 2,
}

• Falta de vírgula entre itens

{
  "a": 1
  "b": 2
}

✅ 4. DOIS PONTOS (:)

Sempre aparecem entre:

"chave": valor

❌ Errado:

"chave" = "valor"

✔ Certo:

"chave": "valor"

✅ 5. QUEBRAS DE LINHA

✔ Aceitas
❌ Não afetam o JSON
✔ Você pode escrever em uma linha ou formatado

{"a":1,"b":2}

ou

{
  "a": 1,
  "b": 2
}

✅ 6. CARACTERES VÁLIDOS E INVÁLIDOS

Válidos:

• Letras
• Números
• Espaços
• Quebras de linha
• Emoji (se bem codificados)
• Símbolos dentro de strings (ex.: @ # $ %)

Inválidos:

• Comentários (// ou /* */)
• Caracteres especiais dentro de strings sem escape
• Caracteres fora de UTF-8
• Quebras de linha dentro de uma string sem escape (\n)

✅ 7. O QUE É “ESCAPE” DE CARACTERES?

Quando se precisa colocar dentro de uma string um caractere que quebraria o JSON, é necessário “escapar” usando uma barra invertida \.

Exemplo:

✔ Correto

{ "texto": "Ele disse: \"Olá\"" }

❌ Errado

{ "texto": "Ele disse: "Olá"" }

✅ 8. TIPOS DE VALORES ACEITOS EM JSON

❌ Não existe em JSON:

• undefined
• function() {}
• NaN, Infinity
• Datas como tipos (devem ser strings)
• Comentários

✅ 9. EXEMPLO DE BODY JSON 100% CORRETO

{
  "nome": "Ana",
  "email": "ana@example.com",
  "idade": 25,
  "ativo": true,
  "preferencias": ["notícias", "promoções"],
  "endereco": {
    "cidade": "São Paulo",
    "uf": "SP"
  }
}

🚨 10. ERROS MAIS COMUNS QUE INVALIDAM UM JSON

• ❌ Usar aspas simples
• ❌ Vírgula sobrando no último item
• ❌ Esquecer vírgula entre itens
• ❌ Comentários no JSON
• ❌ Caracteres especiais sem escape
• ❌ Chaves sem aspas
• ❌ Codificação inválida
• ❌ Usar valores que JSON não suporta (undefined, função, NaN)