REST API

Cos’è una REST API?

Una REST API è un’interfaccia web basata sullo stile architetturale REST (Representational State Transfer), in cui due sistemi si scambiano dati tramite protocollo HTTP. Ogni risorsa — come ad esempio un prodotto o un ordine — ha un proprio URL e viene gestita utilizzando i metodi standard GET, POST, PUT e DELETE. Le risposte sono quasi sempre fornite in formato JSON. REST è stateless (privo di stato): ogni richiesta contiene tutte le informazioni necessarie al server e non viene memorizzata alcuna sessione tra una chiamata e l’altra.

Perché una REST API è importante?

Una REST API è il collante tra il tuo negozio e i sistemi circostanti: ERP, magazzino, PIM, piattaforme email e contabilità. Al posto di esportazioni e importazioni manuali, i dati possono essere sincronizzati in automatico affinché scorte, prezzi e ordini rimangano coerenti tra i vari sistemi. Un’integrazione ben progettata riduce gli errori e il lavoro manuale — mentre un flusso API strutturato male può raggiungere i limiti di velocità o creare conflitti nei dati.

Casi d’uso comuni

• Sincronizzazione di inventario e prezzi tra Shopify e un sistema ERP o di magazzino.
• Creazione o aggiornamento automatico dei prodotti a partire da un feed di prodotti.
• Esportazione di ordini verso la contabilità o un sistema di spedizione.
• Ricerca di dati su clienti o ordini da un’app o dashboard esterna.
• Ricezione di eventi tramite webhook per evitare di interrogare continuamente l’API.

Prospettiva Shopify

Shopify ha reso l’API Admin GraphQL la sua API principale, e l’API Admin REST è ora in modalità di manutenzione — dal 1° aprile 2025, tutte le nuove app pubbliche devono essere create su GraphQL. Scegli quindi GraphQL per le nuove integrazioni. Indipendentemente dal protocollo, le chiamate sono limitate con un algoritmo leaky bucket (un secchio da 40 richieste sui piani standard), quindi progetta il tuo codice per rispettare i limiti e utilizza i webhook invece di un polling frequente.