JSON (JavaScript Object Notation) è un formato di dati leggero e testuale, costruito con coppie chiave-valore annidate e array, pensato per rappresentare dati strutturati in modo facile da elaborare per le macchine e ragionevolmente leggibile anche per una persona. È nato da JavaScript ma oggi è indipendente dal linguaggio ed è diventato il formato predefinito della maggior parte delle API web moderne, sostituendo alternative più vecchie e prolisse in molti casi d'integrazione. Nella gestione dei feed, JSON compare meno come formato del feed shopping finale e più come formato su cui si basa sempre di più tutto ciò che sta intorno a quel feed.
Perché JSON è importante per le integrazioni dei feed
La maggior parte dei feed di prodotto inviati direttamente a un canale shopping è ancora in XML o CSV, ma i sistemi che creano e gestiscono quei feed (PIM, ERP, piattaforme di gestione dei feed e le API che li collegano) comunicano tra loro in larghissima parte in JSON. Quando uno strumento di gestione dei feed estrae l'inventario in tempo reale da un'API, verifica lo stock tramite il payload di un webhook o scambia dati con un PIM, quei dati sono quasi sempre JSON, anche se vengono convertiti in XML prima dell'invio a Google o Meta. Conoscere JSON è importante per chiunque debba risolvere problemi in un'integrazione di feed, perché JSON vive soprattutto nei collegamenti tra i sistemi, non nel file di feed finale.
Come funziona JSON
Un documento JSON è costruito con un piccolo insieme di elementi primitivi: oggetti, cioè coppie chiave-valore racchiuse tra parentesi graffe; array, cioè elenchi ordinati racchiusi tra parentesi quadre; e valori scalari come stringhe, numeri e booleani. Il formato non impone uno schema fisso: un parser JSON non richiede un tipo di documento predefinito, ed è anche per questo che è così diffuso per le risposte delle API che devono evolvere senza rompere i client più vecchi. Quando una piattaforma di feed riceve un payload JSON dall'API di un data feed o da un webhook, di solito ne elabora la struttura e mappa i campi in ciò che richiede il formato del feed di destinazione, spesso XML.
Esempio: dati JSON dietro un articolo di un feed XML
<!--
Source payload from the merchant's API, before conversion:
{
"sku": "SKU-51290",
"title": "Recycled Denim Tote Bag",
"price": { "amount": 38.00, "currency": "USD" },
"availability": "in_stock"
}
-->
<item>
<g:id>SKU-51290</g:id>
<title>Recycled Denim Tote Bag</title>
<g:price>38.00 USD</g:price>
<g:availability>in stock</g:availability>
</item>Il blocco commentato mostra lo stesso prodotto come esiste in JSON, il formato che la maggior parte degli strumenti di gestione dei feed estrae effettivamente da un'API, prima di essere trasformato nei tag XML che un canale shopping si aspetta.
Concetti correlati
JSON è il formato di collegamento alla base di gran parte dell'automazione da cui oggi dipendono i feed, che si tratti di un'API che restituisce dati di stock in tempo reale o di un webhook che invia una variazione di prezzo nel momento stesso in cui avviene nel sistema di origine. Compare inoltre sempre più spesso come formato alternativo di invio per il data feed stesso, man mano che più piattaforme aggiungono opzioni di caricamento basate su JSON accanto al tradizionale supporto per XML e CSV.
