Quando due programmi si scambiano informazioni senza che nessuno copi dati a mano, quasi sempre c’è di mezzo un’API. Il sistema che la espone stabilisce quali dati si possono leggere, quali operazioni si possono eseguire e in che formato vanno inviate le richieste; chi la usa segue quelle regole e ottiene risposte prevedibili.
Come funziona
- REST è lo stile più diffuso per le API web: le richieste viaggiano su HTTP verso indirizzi che rappresentano le risorse, come clienti od ordini, con metodi come GET per leggere e POST per creare, e le risposte arrivano di solito in JSON.
- Ogni chiamata deve dimostrare chi la fa, spesso con una chiave API o un token inviato nell’intestazione della richiesta, e conviene legare la chiave a un utente che abbia solo i permessi necessari.
- Molti servizi fissano un numero massimo di richieste in un certo intervallo di tempo, quindi un’integrazione ben fatta raggruppa le chiamate e ritenta quando riceve un errore di limite superato.
Un esempio: gestionale e CRM
Un produttore di quadri elettrici gestisce le offerte nel CRM e gli ordini nell’ERP. Quando un’opportunità viene chiusa come vinta, un flusso legge i dati dal CRM e crea l’ordine di vendita nel gestionale attraverso la sua API. In senso inverso, ogni notte riporta nel CRM la situazione dei pagamenti, così il commerciale sa quali clienti hanno scadenze aperte prima di preparare una nuova offerta.
In Odoo
La documentazione di Odoo 19 descrive un’API esterna a cui si accede inviando richieste POST in JSON a indirizzi del tipo /json/2/<modello>/<metodo>, per esempio /json/2/res.partner/search_read per cercare i contatti. La chiave va nell’intestazione Authorization come bearer token, viene mostrata una sola volta al momento della creazione e non può durare più di tre mesi; ogni operazione rispetta i diritti dell’utente a cui la chiave appartiene e Odoo consiglia di creare utenti bot dedicati. L’accesso ai dati tramite API esterna è disponibile solo sui piani Custom, mentre i protocolli XML-RPC e JSON-RPC sono deprecati e destinati alla rimozione con Odoo 20.
Se devi collegare gestionale, CRM e altri software, trovi come impostiamo le integrazioni nella pagina automazioni.
Automazioni e integrazioni tra gestionale, CRM e strumenti che già usate.
Raccontaci il processoVoce aggiornata il · Torna al glossario