{"id":329,"date":"2021-01-14T11:52:00","date_gmt":"2021-01-14T10:52:00","guid":{"rendered":"https:\/\/brentasoft.com\/blog\/cos-e-una-api-rest-guida-non-sviluppatori\/"},"modified":"2021-01-14T11:52:00","modified_gmt":"2021-01-14T10:52:00","slug":"cos-e-una-api-rest-guida-non-sviluppatori","status":"publish","type":"post","link":"https:\/\/brentasoft.com\/blog\/cos-e-una-api-rest-guida-non-sviluppatori\/","title":{"rendered":"Cos’\u00e8 una API REST: spiegata per non sviluppatori"},"content":{"rendered":"

“Cos’\u00e8 una API REST?”<\/strong> Se sei un IT manager o un imprenditore alle prese con l’integrazione di gestionali, e-commerce, CRM e servizi cloud, questa domanda ti perseguita. Ti dicono che servono le API per “far parlare i sistemi”, ti propongono integrazioni che costano migliaia di euro, ma quando chiedi di spiegarti cosa siano davvero, ricevi risposte tecniche piene di acronimi: endpoint<\/em>, JSON<\/em>, verbi HTTP<\/em>, OAuth<\/em>, rate limiting<\/em>. Risultato: o ti fidi e firmi, o rinunci all’integrazione e continui a copiare dati a mano fra i tuoi sistemi.<\/p>\n

Questa guida \u00e8 pensata per chi non programma<\/strong>. Niente codice, niente teoria astratta. Ti spieghiamo cos’\u00e8 una API REST con analogie concrete, esempi reali di PMI italiane, e ti diamo gli strumenti per capire quando un’integrazione ha senso, quando puoi farla con strumenti no-code come Zapier, e quando invece serve davvero uno sviluppatore. Alla fine di questo articolo saprai parlare di API con il tuo fornitore senza sentirti spaesato \u2014 e questo \u00e8 gi\u00e0 met\u00e0 del lavoro per fare scelte tecnologiche intelligenti nel 2021.<\/p>\n

1. API: cosa significa davvero (definizione semplice non-tech)<\/h2>\n

API \u00e8 l’acronimo di Application Programming Interface<\/strong>, in italiano “interfaccia di programmazione delle applicazioni”. Ma questa traduzione letterale non aiuta nessuno a capire. Proviamo con una definizione pi\u00f9 utile: una API \u00e8 un insieme di regole che permette a due software di comunicare fra loro<\/strong>, scambiandosi dati e funzioni in modo automatico, senza intervento umano.<\/p>\n

Pensa al tuo ERP che deve inviare le fatture al commercialista, al tuo e-commerce che deve aggiornare il magazzino del gestionale, al CRM che deve registrare i lead arrivati dal sito. Tutte queste operazioni richiedono che due sistemi diversi \u2014 spesso costruiti da aziende diverse, in linguaggi diversi, su server diversi \u2014 si scambino informazioni in modo strutturato. L’API \u00e8 esattamente questo: il contratto tecnico<\/strong> che definisce come avviene questo scambio.<\/p>\n

Una caratteristica fondamentale delle API moderne \u00e8 che sono standardizzate<\/strong>: chiunque conosca lo standard pu\u00f2 usarle, senza bisogno di un’integrazione su misura. \u00c8 un po’ come la presa elettrica \u2014 non importa chi ha costruito la lampada o chi ha fatto l’impianto, finch\u00e9 tutti rispettano lo standard 220V\/16A italiano, le cose funzionano.<\/p>\n

API \u2260 software con interfaccia grafica<\/h3>\n

La differenza chiave da capire: tu, essere umano, usi un software tramite l’interfaccia utente<\/strong> (UI) \u2014 bottoni, menu, form. Un altro software usa il primo software tramite l’interfaccia di programmazione<\/strong> (API) \u2014 chiamate strutturate che restituiscono dati. Le API esistono proprio perch\u00e9 i computer non hanno bisogno di vedere un bottone “Salva”: gli basta una richiesta diretta che dica “salva questo cliente con questi dati”.<\/p>\n

2. Come funziona una API: l’analogia del “cameriere”<\/h2>\n

L’analogia pi\u00f9 efficace per capire le API \u00e8 quella del ristorante<\/strong>. Immagina di entrare in un ristorante: tu sei seduto al tavolo, in cucina lavorano gli chef, ma non ti precipiti in cucina a prendere il piatto. C’\u00e8 un cameriere<\/strong> che fa da intermediario:<\/p>\n