JSON
JSON
JSON è un formato di testo per la condivisione dei dati. Può contenere oggetti, array, testo, numeri, `true` o `false` e `null`.
Un altro esempio
Un servizio di pagamento invia `{"amount":2400,"currency":"TWD"}` come UTF-8 e lo confronta con un contratto. Un ID fattura a 19 cifre viene inviato come testo perché alcuni sistemi non possono memorizzare esattamente quel numero. I dati con lo stesso nome membro due volte vengono rifiutati.
Parti principali
- 01Valore strutturale
- 02Nomi dei membri o ordine dell'array
- 03Valori primitivi
Usalo quando
Usa JSON per i dati strutturati quando entrambe le parti concordano sui tipi di campo e se `null` sia permesso. Devono anche concordare sui limiti numerici e sulle regole di versione.
Non usarlo quando
JSON non è uno schema. Il JSON standard non permette commenti o `NaN`, e l'ordine dei membri di un oggetto non ha significato.
Nome usato nel codice
application/json; RFC 8259 grammar encoded as UTF-8 for interoperable exchange Prima di spedire
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: Un servizio di pagamento invia `{"amount":2400,"currency":"TWD"}` come UTF-8 e lo confronta con un contratto. Un ID fattura a 19 cifre viene inviato come testo perché alcuni sistemi non possono memorizzare esattamente quel numero. I dati con lo stesso nome membro due volte vengono rifiutati. Technical concept or control: JSON (JSON). Why it fits: Usa JSON per i dati strutturati quando entrambe le parti concordano sui tipi di campo e se `null` sia permesso. Devono anche concordare sui limiti numerici e sulle regole di versione. Do not use it when: JSON non è uno schema. Il JSON standard non permette commenti o `NaN`, e l'ordine dei membri di un oggetto non ha significato. 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): Lo standard copre solo l'ambito elencato. Non sceglie lo stile visivo, la decisione sul prodotto o l'esempio di vocabolario. 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.
Controlla questa richiesta
Review how JSON (JSON) is used now. Definition: JSON è un formato di testo per la condivisione dei dati. Può contenere oggetti, array, testo, numeri, `true` o `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.