Le API più comuni per iniziare: pagamenti, email, AI, mappe

Nella lezione precedente abbiamo visto come integrare una API esterna in Lovable: connettori pronti, chiamate dirette, secrets ed edge function per i casi autenticati. Questa lezione, che chiude il modulo, non aggiunge un nuovo meccanismo tecnico: è una mappa di orientamento tra i quattro tipi di servizio esterno che si incontrano più spesso in un progetto reale, pagamenti, email, intelligenza artificiale, mappe, con le domande giuste da farsi prima di collegarne uno.

## In breve

Quattro categorie di API tornano più di ogni altra in un progetto costruito con Lovable: pagamenti (tipicamente Stripe), email (tipicamente Resend), intelligenza artificiale (l'AI nativa di Lovable, o un provider come OpenAI quando serve qualcosa di specifico), mappe (tipicamente Google Maps Platform). Per tre di queste quattro categorie, Lovable offre già una soluzione integrata che evita di gestire manualmente chiavi ed endpoint: vale sempre la pena controllare quella strada prima di lanciarsi in un'integrazione diretta.

Che cos'è (e cosa NON è)

Questa lezione non è una guida passo-passo per integrare ciascuno di questi servizi, il procedimento generale l'abbiamo già visto nella lezione precedente, ed è simile per tutti i casi autenticati. È invece una mappa per capire, prima di iniziare, quale servizio serve davvero, cosa fa nella pratica, e se conviene la strada integrata di Lovable o l'API diretta del provider.

Come funziona

### Pagamenti

Il servizio di riferimento più diffuso è Stripe, la cui API "è organizzata attorno a REST, con URL orientati alle risorse, prevedibili, e risposte in formato JSON", come descrive la sua stessa documentazione ufficiale. Prima di integrare Stripe direttamente via API, però, vale la pena sapere che Lovable offre pagamenti integrati basati su Stripe o Paddle: creano prodotti, prezzi e checkout descrivendo tutto in linguaggio naturale, gestiscono automaticamente un ambiente di test separato da quello reale, e coprono la maggior parte dei casi, abbonamenti, acquisti singoli, prove gratuite. L'integrazione diretta dell'API di Stripe resta utile per flussi molto specifici che i pagamenti integrati non coprono.

### Email

Il servizio più citato per l'invio di email transazionali da un'applicazione è Resend, che si definisce "l'API email per sviluppatori": richiede un dominio verificato e una chiave API, usata come token nell'header di autenticazione di ogni richiesta. Anche qui, prima di integrare un provider esterno, vale la pena controllare la sezione Emails del backend integrato di Lovable, pensata per inviare email dal proprio dominio senza configurare un servizio esterno da zero. Integrare Resend (o un provider equivalente) via API resta la scelta giusta quando serve un controllo più fine su modelli, statistiche di consegna o campagne.

### Intelligenza artificiale

Qui la scelta di partenza è diversa dalle altre due categorie: Lovable include un connettore AI nativo che aggiunge funzionalità come chatbot, riassunti, generazione di immagini o trascrizione vocale senza bisogno di nessuna chiave API esterna, usando modelli di OpenAI e Google fatturati direttamente sui crediti del proprio spazio di lavoro Lovable. Per la maggior parte dei casi, un assistente in-app, un riassunto automatico, un chatbot di supporto, questa è la strada più semplice e già pronta. Una chiave OpenAI propria, gestita come le altre API tramite secrets ed edge function, serve solo in casi specifici: quando serve un modello o un provider che il connettore nativo non offre (per esempio Anthropic Claude, non disponibile nel connettore nativo secondo la documentazione ufficiale di Lovable), oppure quando si vuole che l'uso venga fatturato sul proprio account del provider invece che sui crediti Lovable.

### Mappe

Per mostrare una mappa su un sito, Google Maps Platform è il punto di riferimento più diffuso. Un dato verificabile e utile da sapere: la Maps Embed API, quella che serve per incorporare semplicemente una mappa in una pagina, è gratuita e senza limiti di richieste, secondo la documentazione ufficiale di Google aggiornata ad agosto 2026, richiede comunque una chiave API da configurare, ma non comporta costi per l'uso base. Altri servizi della stessa piattaforma, calcolo di indirizzi (geocoding), ricerca di luoghi, mappe interattive avanzate, hanno invece un modello a consumo con una soglia gratuita mensile, oltre la quale si paga per richiesta: vale la pena controllare la pagina ufficiale dei prezzi prima di scegliere quale servizio della piattaforma serve davvero.

## Perché conta

Sapere quale servizio esiste per ciascuna di queste esigenze evita due errori opposti: costruire da zero qualcosa che un servizio esterno già fa meglio (un sistema di pagamento fatto in casa, per dire, è un progetto enormemente più complesso e rischioso di quanto sembri), oppure integrare manualmente un'API quando Lovable offre già una scorciatoia pronta e testata, come nel caso dei pagamenti integrati o dell'AI nativa. La domanda da farsi non è "quale API dovrei integrare", ma "questa funzionalità è già coperta da qualcosa che ho a disposizione, prima di cercare altrove".

## Esempio lampante

### Contesto ipotetico

un centro yoga vuole (1) far pagare l'iscrizione mensile online, (2) mandare un'email di conferma dopo l'iscrizione, (3) mostrare la mappa dello studio sul sito.

INPUT. La richiesta, tutta insieme: "Voglio che le persone possano iscriversi e pagare online, ricevere una conferma via email, e vedere dove siamo sulla mappa."

ANALISI. Sono tre esigenze distinte, con tre soluzioni diverse. Il pagamento ricorrente è un caso da manuale per i pagamenti integrati di Lovable (abbonamento mensile, gestione automatica dei rinnovi). L'email di conferma può passare dal modulo Emails del backend integrato, senza bisogno di un provider esterno. La mappa, essendo solo una visualizzazione statica della posizione, non ha bisogno di nulla di più della Maps Embed API gratuita.

DECISIONE. Il centro yoga sceglie: pagamenti integrati con Stripe per l'abbonamento, email di conferma dal backend integrato, mappa incorporata con la Maps Embed API. Nessuna delle tre richiede di gestire manualmente una chiave API esterna con secrets ed edge function dedicate.

OUTPUT. Un flusso di iscrizione completo, dove ogni pezzo usa la soluzione più diretta disponibile, senza integrazioni dirette non necessarie.

Come farlo

1. Per i pagamenti, valuta prima i pagamenti integrati di Lovable (Stripe o Paddle): coprono abbonamenti, acquisti singoli, prove gratuite e checkout, con ambiente di test separato. Passa all'API diretta di Stripe solo per flussi che quella soluzione non copre.
2. Per le email, valuta prima il modulo Emails del backend integrato, per inviare dal proprio dominio senza servizio esterno. Integra un provider come Resend quando serve un controllo più fine.
3. Per l'intelligenza artificiale, valuta prima il connettore AI nativo di Lovable: nessuna chiave da gestire, fatturato a crediti dello spazio di lavoro. Usa una chiave propria di un provider solo se serve un modello specifico non incluso, o una fatturazione separata.
4. Per le mappe, se ti serve solo mostrare una posizione, usa la Maps Embed API (gratuita, illimitata, ma richiede comunque una chiave). Per funzioni più avanzate, ricerca di indirizzi, calcolo di percorsi, controlla prima la pagina ufficiale dei prezzi della piattaforma scelta.
5. In tutti i casi in cui serve una chiave API propria, seguila il percorso visto nella lezione precedente: mai in chat o nel codice, sempre nei Secrets.

## Errori comuni

Scegliere il servizio più famoso senza chiedersi se serve davvero

Integrare Stripe direttamente via API per un'associazione che raccoglie tre pagamenti l'anno è uno sforzo sproporzionato rispetto a usare i pagamenti integrati di Lovable, pensati apposta per non dover gestire questi dettagli.

Duplicare una funzionalità che Lovable offre già nativamente

Integrare manualmente un provider AI esterno per un chatbot semplice, quando il connettore nativo lo farebbe senza nessuna chiave da gestire, aggiunge complessità senza un vantaggio reale.

Non controllare i costi prima di collegare un servizio a consumo

Alcuni servizi (come le funzioni avanzate di una piattaforma mappe) hanno una soglia gratuita seguita da un costo per richiesta: partire senza aver letto la pagina ufficiale dei prezzi può portare a sorprese quando il progetto cresce.

Quando questo argomento conta meno

Per un prototipo o una demo interna, spesso nessuna di queste API serve davvero: dati di esempio bastano finché il prodotto non deve gestire soldi reali, email reali o dati reali di utenti. Collegare pagamenti, email o mappe prima che il flusso sia stato verificato con dati finti è un lavoro che spesso va rifatto quando il prototipo cambia forma, meglio arrivarci quando la struttura è già stabile.

## In sintesi

Pagamenti, email, intelligenza artificiale e mappe sono i quattro tipi di servizio esterno più comuni in un progetto Lovable. Per tre di questi, Lovable offre già una soluzione integrata (pagamenti, email, AI) che evita di gestire manualmente chiavi e integrazioni dirette: vale sempre la pena controllarla prima. L'integrazione diretta di un'API esterna resta la strada giusta quando serve qualcosa che quella soluzione non copre.

## Cosa imparare dopo

Con le basi di API e integrazioni acquisite, il corso prosegue nel prossimo modulo con un altro pilastro del vibe coding che vale la pena conoscere anche senza saper programmare: GitHub, come funziona e perché conviene collegarlo a un progetto Lovable.

---

Vuoi provarlo?

Prova Lovable →

Link di affiliazione: se ti iscrivi da qui, ricevo una piccola commissione, a te non cambia nulla.