Format Atlas

Guide

Scegliere formati per dati e configurazione Web

Valuta JSON per scambi tra macchine come le API, YAML per impostazioni modificate da persone e XML per integrazioni esistenti basate su schemi.

Quale formato scegliere?

Scegli in base al ruolo di ogni file nel flusso di lavoro.

  • API Web → JSON
  • Impostazioni modificate a mano → YAML
  • Schema o contratto esistente → XML

Usare il formato richiesto dal destinatario

Tutti e tre rappresentano dati strutturati, ma differiscono per sintassi, commenti, tipi e uso degli schemi. Verifica prima contratto e strumenti.

Formati da considerare

JSON

Adatto per: API e scambio basato su JSON

Meno adatto per: Impostazioni manuali con commenti

YAML

Adatto per: Configurazione mantenuta da persone

Meno adatto per: API che accettano solo JSON

XML

Adatto per: Schemi e integrazioni XML esistenti

Meno adatto per: Nuove API semplici senza requisiti XML

Cosa controllare prima dell’esportazione

  • Non presumere che YAML sia un superset rigoroso di JSON.
  • Conferma codifica, tipi e gestione degli schemi con il destinatario.

Confronti correlati

JSON vs YAMLJSON è un formato testuale rigoroso molto usato per API e scambio di dati tra programmi. YAML offre una sintassi adatta a configurazioni e dati strutturati modificati da persone. Scegli secondo ecosistema e flusso.XML vs JSONXML e JSON sono formati testuali per dati strutturati, ma usano strutture e convenzioni diverse.

Guide

Scegliere un formato di scambio datiParti dalla specifica del sistema ricevente. Usa JSON per dati API strutturati, XML se l'integrazione richiede uno schema e CSV per una singola tabella.

Riferimenti e specifiche