
Un traduttore tra REST moderno e SOAP legacy
REST e SOAP possono convivere: isola il servizio legacy in un adapter e lascia al resto dello stack un'interfaccia semplice. Così una scelta obbligata non diventa il vincolo di tutta l'architettura.
Due approcci, due mondi: REST semplice e moderno, SOAP rigido e enterprise. Come orientarsi nella scelta di quale API usare per il tuo gestionale, il tuo e-commerce, la tua integrazione con sistemi bancari o legacy.

REST e SOAP possono convivere: isola il servizio legacy in un adapter e lascia al resto dello stack un'interfaccia semplice. Così una scelta obbligata non diventa il vincolo di tutta l'architettura.
Un'API è semplicemente un linguaggio di comunicazione tra due software. Senza API, ogni integrazione sarebbe una riscrittura da zero: il tuo gestionale dovrebbe imparare il linguaggio interno del sistema bancario, che dovrebbe imparare il linguaggio del tuo e-commerce, e così via.
Con un'API, il fornitore del sistema bancario dice: "Ecco, se mi parli così (seguendo queste regole, in questo formato), io ti capisco e ti rispondo". Stessa cosa per il tuo gestionale verso il suo e-commerce, il suo magazzino, il suo CRM.
L'API è quindi un contratto: definisce come due software dialogano, quali dati si scambiano, e che cosa succede quando uno richiede qualcosa all'altro.
Esistono molti tipi di API, ma i due più importanti nel mondo business sono: REST e SOAP. Entrambi rispettano il contratto API, ma lo fanno in modo molto diverso.
REST è l'acronimo di "Representational State Transfer". Suona complicato, ma è l'approccio più semplice.
Come funziona REST:
Vantaggi di REST: Facile da imparare, facile da usare, ecosistema di strumenti immenso, sfidarsi i problemi di performance è raro, compatibile con quasi tutto, documentazione abbondante ovunque.
Quando REST è la scelta giusta: Nuovi progetti, integrazioni moderne, cloud, app mobile, e-commerce, qualunque cosa costruita negli ultimi dieci anni.
SOAP è l'acronimo di "Simple Object Access Protocol". Ironicamente, non è semplice.
Come funziona SOAP:
Svantaggi di SOAP: Complesso da imparare, pesante in termini di dati scambiati, più lento di REST, meno ecosistema di strumenti, documentazione spesso poco chiara, debugging difficile, cambiar contratti è difficile (e costoso).
Quando SOAP era la scelta giusta: Anni 2000-2010, quando standardizzazione e formalità erano priorità assolute, e i sistemi enterprise dovevano "parlare" con forza e precisione.
Se SOAP è complicato e REST è più semplice, perché SOAP esiste ancora?
La risposta è storica e politica.
Sistemi bancari: La banca che usa le tue carte di credito comunica via SOAP. Perché? Perché ha investito miliardi nei sistemi SOAP negli anni 2000, e cambiarli costerebbe più di quanto valga ricavarne il beneficio. Inoltre, i servizi di pagamento e transazioni finanziarie hanno bisogno di quel contratto rigido WSDL: non puoi permetterti ambiguità quando scambiate soldi.
Pubblica Amministrazione: La PA italiana, quella delle Agenzia delle Entrate, dei municipi, degli enti pubblici, comunica tramite SOAP. Stesso motivo: è stato lo standard internazionale quando hanno dovuto standardizzare, e non hanno mai migrato.
Sistemi legacy aziendali: Se la tua azienda ha un ERP SAP, Oracle, o altro sistema enterprise installato nel 2005, quell'API è probabilmente SOAP. Cambiare API significa riscrivere l'intera infrastruttura di integrazione: costi enormi.
Integrazioni obbligate: A volte il tuo software deve integrarsi con un sistema bancario per forza (cassa, pagamenti). Se il banco espone solo SOAP, devi usare SOAP, anche se non vuoi. Non è una scelta: è una necessità.
Negli ultimi dieci anni, REST è diventata lo standard di fatto per qualunque cosa nuova. Perché?
Semplicità per sviluppatori: Imparare REST richiede ore, imparare SOAP richiede giorni. Gli sviluppatori preferiscono semplicità, e i project manager preferiscono developer felici.
Compatibilità ubiqua: REST gira su HTTP, che è il protocollo del web. Se il tuo sistema parla HTTP (e tutti lo fanno), parla REST. SOAP richiede librerie speciali, dipendenze aggiuntive, setup più complesso.
Velocità di sviluppo: Aggiungere un endpoint REST prende minuti. Aggiungere un servizio SOAP richiede generare il WSDL, aggiornare le definizioni di schema, riscrivere la documentazione. REST è iterativo e agile, SOAP è rigido e lento.
Ecosistema di strumenti: Qualunque linguaggio moderno (Python, Node.js, Go, Rust) ha librerie REST built-in o quasi. SOAP richiede librerie dedicate, spesso mantenute male.
Scalabilità e performance: REST è stateless. Scalare orizzontalmente è banale: aggiungi server, tutti identici, tutti indipendenti. SOAP stateful è più difficile da scalare: devi mantenere stati, sessioni, affinity.
Mobile e cloud: Le app mobile parlano REST. Le API cloud (AWS, Azure, Google Cloud) espongono REST. Se il tuo sistema deve essere moderno, REST è inevitabile.
Se stai scegliendo un gestionale, un'app, o un sistema cloud nuovo, la risposta è semplice: scegli REST.
REST è più semplice, più veloce da sviluppare, più facile da mantenere, ha più strumenti, e il mercato si aspetta REST. Nessun fornitore moderno di software espone API SOAP di nuova creazione.
Ma non è sempre una tua scelta. A volte la tua decisione è vincolata:
Caso 1: Devi integrarti con il tuo sistema bancario. Il banco espone solo SOAP? Devi usare SOAP per quella integrazione specifica. Ma il resto del tuo software può comunque usare REST. Non è il massimo, ma è fattibile: chiedi al tuo fornitore un adattatore SOAP→REST, una specie di "traduttore" che converte SOAP in REST. Non è ideale, ma risolve.
Caso 2: Devi integrarti con un ERP legacy (SAP, Oracle). Stesso discorso. Quell'integrazione sarà SOAP, ma non deve inquinare il resto del tuo stack. Una buona architettura ha un layer di integrazione (magari un middleware, o un servizio dedicato) che parla SOAP al legacy, e REST al resto del mondo.
Caso 3: Scegli un gestionale nuovo. Assicurati che usi REST per le sue API pubbliche. Se un fornitore ti dice "le mie API sono SOAP", è un segnale di allarme. Significa che non ha modernizzato il suo sistema, o non ritiene importante stare al passo con il mercato.
La regola aurea: Isola le integrazioni legacy (SOAP) in un layer dedicato. Assicurati che il resto del tuo software usi REST. Questo ti dà flessibilità per migrare più tardi, senza dover riscrivere tutto.
Prima di scegliere un gestionale, un ERP, o un sistema cloud, fai queste domande:
La maggior parte dei business sceglie REST senza saperlo. È quello che succede quando usi un software moderno: dietro le quinte, le API sono REST. Il fatto che SOAP ancora esista è una conseguenza della storia, non del design.
Approfondisci gli argomenti di questo articolo:
REST, SOAP, integrazioni, modernità: sappiamo come guidarti nella scelta. Ti aiutiamo a valutare il tuo software e a scegliere architetture che scalano.