Definição
JavaScript Object Notation: formato de texto para dados estruturados, com objetos, listas, textos, números, booleanos e null. É o formato mais usado em APIs web.
Como funciona
O JSON é definido no RFC 8259 (e no ECMA-404). Objetos ficam entre chaves, com pares "nome": valor; listas, entre colchetes. Os textos usam aspas duplas e, na troca entre sistemas, devem estar em UTF-8.
Não há tipo de data nem comentários: datas costumam ir como texto no formato ISO 8601 ("2026-10-20T14:30:00Z"), e comentários não são permitidos.
O formato não limita a precisão dos números, mas cada linguagem limita: em JavaScript, inteiros acima de 2 elevado a 53 perdem precisão. IDs grandes devem ir como texto.
Na prática
Estado fictício de um ramal devolvido por uma API:
{
"ramal": "2001",
"registrado": true,
"contatos": ["sip:2001@192.0.2.10:5060"],
"expira_em": 3600
}Erro comum
Montar JSON concatenando texto. Aspas, barras e quebras de linha dentro dos valores quebram o documento ou abrem brechas; use sempre o serializador da linguagem.
Termos relacionados
Referências
Padrões e documentação
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format
Para ir além
Veja também o glossário completo, o blog e os cursos da EDCA.