JSON
JSON
JSON é um formato de texto para compartilhamento de dados. Pode conter objetos, arrays, texto, números, `true` ou `false`, e `null`.
Outro exemplo
Um serviço de pagamento envia `{"amount":2400,"currency":"TWD"}` como UTF-8 e verifica isso contra um contrato. Um ID de fatura de 19 dígitos é enviado como texto porque alguns sistemas não conseguem armazenar esse número exatamente. Dados com o mesmo nome de membro duas vezes são rejeitados.
Partes principais
- 01Valor estrutural
- 02Nomes dos membros ou ordem do array
- 03Valores primitivos
Use-o quando
Use JSON para dados estruturados quando ambos os lados concordarem com os tipos de campo e se `null` é permitido. Eles também devem concordar com os limites de números e regras de versão.
Não o use quando
JSON não é um esquema. JSON padrão não permite comentários nem `NaN`, e a ordem dos membros do objeto não tem significado.
Nome usado no código
application/json; RFC 8259 grammar encoded as UTF-8 for interoperable exchange Antes de lançar
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Complete the task with JSON (JSON). User context: Um serviço de pagamento envia `{"amount":2400,"currency":"TWD"}` como UTF-8 e verifica isso contra um contrato. Um ID de fatura de 19 dígitos é enviado como texto porque alguns sistemas não conseguem armazenar esse número exatamente. Dados com o mesmo nome de membro duas vezes são rejeitados. Technical concept or control: JSON (JSON). Why it fits: Use JSON para dados estruturados quando ambos os lados concordarem com os tipos de campo e se `null` é permitido. Eles também devem concordar com os limites de números e regras de versão. Do not use it when: JSON não é um esquema. JSON padrão não permite comentários nem `NaN`, e a ordem dos membros do objeto não tem significado. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): O padrão cobre apenas o escopo listado. Ele não escolhe o estilo visual, decisão do produto ou exemplo de Vibulary. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Conferir este pedido
Review how JSON (JSON) is used now. Definition: JSON é um formato de texto para compartilhamento de dados. Pode conter objetos, arrays, texto, números, `true` ou `false`, e `null`. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.