Usare le API senza programmare: dalla chiave alla prima chiamata

Ti hanno detto che con le API puoi collegare il modulo del tuo sito a un database, a un gestionale o a una chat. Tu non scrivi codice e ti blocchi alla prima sigla in inglese. Questa pagina spiega come usare le API senza programmare, con strumenti a blocchi come Make, fino alla tua prima chiamata a una tabella Airtable.

È pensata per chi gestisce una PMI, un’associazione o un lavoro da freelance e usa già strumenti no-code. Trovi cosa succede in una chiamata, a cosa serve la chiave, la procedura passo dopo passo in Make, come farti aiutare da un’AI a preparare la chiamata, tre esempi con Airtable, ClickUp e Softr e una tabella per scegliere fra Make, Zapier e n8n.

Come abbiamo lavorato: documentazione ufficiale, fonti esterne e l’esperienza diretta di chi scrive, che ha provato Make e Airtable a fondo su un progetto. Alcuni link sono di affiliazione: se acquisti, il sito riceve una commissione, il prezzo per te non cambia.

API o api? Non sono gli insetti

In italiano la stessa parola indica due cose: le api, gli insetti che fanno il miele e interessano l’apicoltura, e le API, che sono software. Qui si parla solo delle seconde, e le scrivo in maiuscolo. API è la sigla di Application Programming Interface, cioè il modo in cui un programma chiede dati o azioni a un altro.

Cosa sono le API in parole semplici

Pensa al cameriere di un ristorante. Tu ordini da un menu con regole precise, la cucina prepara, il cameriere riporta il piatto. Il programma che ordina si chiama client, quello che risponde si chiama server.

Ogni servizio che usi ha la sua cucina e il suo menu. Airtable tiene le tabelle, ClickUp le attività, Make le automazioni. Le API sono il menu che il produttore pubblica per farti collegare quei dati a un altro software senza aprire a mano ogni schermata.

Come funziona una chiamata API: indirizzo, richiesta e risposta

Una chiamata API è una richiesta con cinque pezzi. Quando usi uno strumento a blocchi li compili in un modulo, senza scrivere una riga.

• Indirizzo (in gergo endpoint): l’URL a cui mandi la richiesta, che inizia con https.
• Metodo: GET per leggere, POST per creare. Esistono anche PUT, PATCH e DELETE per modificare e cancellare.
• Credenziali: la chiave API o il token che dice al servizio chi sei.
• Corpo: i dati che mandi, scritti in JSON, cioè un testo ordinato in coppie nome e valore.
• Risposta: i dati che tornano e un codice numerico.

I codici che incontri più spesso sono 200 (è andato tutto bene), 401 (non autorizzato: di solito la chiave è sbagliata o scaduta) e 404 (l’indirizzo non esiste). Se leggi uno di questi nella risposta di un modulo, sai già dove guardare.

Come usare le API senza programmare: tre strade

• Moduli già pronti. Uno strumento come Make include integrazioni con più di 1.000 app (pagina prezzi di Make): scegli l’app e l’azione, e la chiamata la fa lui.
• Il modulo HTTP. Per un servizio senza modulo pronto, Make ha «Make a request», che manda una richiesta a qualsiasi server. Compili indirizzo, metodo e dati; è la strada di questa guida.
• Un catalogo di API da scegliere. Se non sai da dove partire, la pagina catalogo di API per automazioni elenca oltre 80.000 servizi da collegare a Make, n8n e Zapier.

La differenza pratica è questa: con un modulo pronto scegli da un elenco, con il modulo HTTP ti serve la documentazione del servizio per copiare indirizzo e metodo. È più lavoro, ma funziona anche con servizi che nessuno ha ancora messo in un elenco.

La chiave API: cos’è e come tenerla al sicuro

La chiave API è un codice lungo che sostituisce nome utente e password quando un programma parla con un altro. Chi la possiede può fare quello che la chiave permette, quindi va trattata come una password.

In Airtable si chiama token personale: lo crei dalla pagina dei token di Airtable scegliendo un nome, i permessi (gli scopes, per esempio data.records:write per creare righe) e le tabelle a cui dà accesso. Il token si vede una sola volta alla creazione e si manda come Bearer nell’intestazione Authorization; il vecchio parametro api_key nell’indirizzo non è supportato (documentazione di Airtable). In ClickUp il token personale si genera da Impostazioni, poi Apps, poi API Token, e inizia con pk_ (documentazione di ClickUp).

In Make la chiave non va scritta nelle intestazioni o nell’indirizzo: la documentazione consiglia di impostare il tipo di autenticazione su «API key» e di creare un keychain nel campo delle credenziali, perché evita di esporre la chiave e rende più facile cambiarla (app HTTP di Make). Dai a ogni token solo i permessi che servono e non incollarlo mai in una chat, in una pagina pubblica o in uno screenshot.

La tua prima chiamata API con Make, passo dopo passo

L’esempio: un nuovo contatto compila un modulo e tu vuoi che finisca come riga in una tabella Airtable. Serve un account Make (la recensione spiega anche i piani) e un token Airtable con il permesso data.records:write.

• Crea uno scenario in Make e aggiungi il modulo HTTP «Make a request».
• Nel campo URL scrivi l’indirizzo di Airtable per creare righe: https://api.airtable.com/v0/ seguito dall’ID della base e dal nome della tabella (documentazione di Airtable).
• Come metodo scegli POST, perché stai creando una riga.
• Come tipo di autenticazione scegli «API key» e, nel campo delle credenziali, crea il keychain con il tuo token.
• Come tipo di contenuto del corpo scegli «application/JSON». Puoi compilare i dati con una struttura guidata («Data structure») o incollarli come testo («JSON string»): un oggetto fields con il nome di ogni colonna e il suo valore, per esempio Name e Email.
• Metti «Parse response» su Sì, così la risposta si legge a campi; i campi da usare nei moduli successivi compaiono dopo che hai eseguito il modulo una volta.
• Esegui lo scenario e controlla la tabella. Se Make mostra 401 o 404, riguarda il token e l’indirizzo. Airtable vuole la parola Bearer davanti al token nell’intestazione Authorization (documentazione di Airtable): se ricevi 401, controlla anche come hai scritto il token e che abbia il permesso giusto.

Make accetta solo indirizzi https e rifiuta i certificati non verificati, quindi non puoi puntare a un indirizzo http semplice (documentazione di Make). Il piano gratuito di Make comprende 1.000 crediti al mese e di solito ogni azione di uno scenario ne consuma 1 (pagina prezzi ufficiale, letta il 23/10/2026): uno scenario con due moduli consuma pochi crediti a ogni prova.

Come chiedere a un’AI di preparare la chiamata API

Un assistente AI può compilarti indirizzo, metodo e corpo della chiamata, ma solo se gli chiedi con i termini giusti e gli dai la fonte. Può sbagliare indirizzi e nomi di campo senza accorgersene. Il risultato va sempre confrontato con la pagina ufficiale del servizio.

Regola di sicurezza: non incollare mai la chiave o il token nella chat. Scrivi al suo posto TUO_TOKEN e inserisci quello vero solo nel keychain di Make.

Cosa dare all’AI, in ordine:

1. Il nome del servizio e l’azione: «creare una riga in una tabella Airtable».
2. Il testo della pagina della documentazione ufficiale di quell’azione, copiato nella chat.
3. Lo strumento che userai: il modulo HTTP «Make a request» di Make.
4. I dati da mandare, con i nomi esatti delle colonne.
5. Cosa vuoi in cambio: indirizzo, metodo, intestazioni, corpo in JSON e codice di risposta che indica successo.

Un esempio di richiesta, da adattare: «Devo creare una riga in una tabella Airtable con il modulo HTTP «Make a request» di Make. Sotto ti incollo la pagina «Create records» della documentazione ufficiale.

Dammi l’endpoint con segnaposto per l’ID della base e il nome della tabella, il metodo, le intestazioni necessarie (scrivi TUO_TOKEN al posto del token), il corpo in JSON con i campi Name ed Email e il codice di risposta che indica successo. Poi indicami i due errori più probabili e cosa controllare. Rispondi con una riga per ogni campo del modulo.»

I termini che rendono la richiesta precisa, spiegati in poche parole:

• Endpoint: l’indirizzo a cui mandi la richiesta.
• Metodo: GET per leggere, POST per creare, PATCH per modificare, DELETE per cancellare.
• Header (intestazioni): informazioni extra della richiesta, come il tipo di contenuto.
• Body (corpo) e payload: i dati che mandi.
• JSON: il formato in cui sono scritti i dati, a coppie nome e valore.
• Scopes: i permessi che dai al token.
• Rate limit: quante richieste puoi fare in un certo tempo prima che il servizio ti blocchi.

Quando qualcosa non funziona, incolla all’AI il codice di risposta e il messaggio di errore, senza la chiave, e chiedi cosa controllare per primo. Prova sempre su una tabella di prova, non su quella dei clienti.

Il mio consiglio per chi parte da zero

Fin qui la documentazione. Da qui in poi parlo io.

Il mio consiglio: se non sai come fare una chiamata, chiedilo alla tua AI di fiducia. Prima vai sulla pagina di documentazione delle API del tuo strumento preferito, poi chiedi «cosa può fare questa API?». Quando hai capito cosa vuoi fare, chiedi come farlo.

Certamente l’AI sbaglia: spesso dovrai ripetere una chiamata molte volte e consumerai crediti. Ti assicuro però che alla fine i risultati valgono la fatica: riuscirai a fare cose che prima non potevi nemmeno immaginare.

Webhook: quando è l’altro servizio a chiamare te

Con l’API tu chiedi: il tuo scenario va a prendere o a mandare dati quando decidi tu. Con un webhook succede il contrario: un altro servizio manda i dati a un indirizzo che gli hai dato, e lo scenario parte da solo.

In Make i webhook ricevono dati via https e fanno partire lo scenario appena la richiesta arriva all’indirizzo; l’indirizzo si crea con il modulo «Custom webhooks». Se lo scenario è pianificato, le richieste restano in coda e vengono elaborate al giro successivo. La documentazione indica un massimo di 300 richieste ogni 10 secondi e una coda che dipende dal piano (webhook di Make).

Se ti bastano regole del tipo «quando succede A, fai B», guarda anche la scheda su IFTTT e le alternative a IFTTT.

Tre esempi pratici senza codice

Airtable: una riga da un modulo. È l’esempio qui sopra: POST all’indirizzo della tabella, token con permesso data.records:write, un oggetto fields nel corpo. Se parti da zero, apri un account Airtable e leggi la guida ad Airtable; per estenderlo ci sono le applicazioni per migliorare Airtable.

ClickUp: un’attività da un modulo. Il token personale si manda nell’intestazione Authorization senza altre parole davanti, secondo la documentazione di ClickUp. Per creare l’attività mandi un POST a https://api.clickup.com/api/v2/list/ seguito dall’ID della lista e da /task, con almeno il campo name nel corpo (documentazione «Create Task» di ClickUp). La recensione di ClickUp e la guida al portale clienti in ClickUp mostrano a cosa serve poi l’attività; se vuoi provarlo, apri un account ClickUp.

Softr: una web-app sopra gli stessi dati. Se le righe sono già in Airtable, puoi mostrarle in una web-app senza altro lavoro sulle API: ne parla la recensione di Softr, che costruisce le app proprio sopra Airtable. Per vedere i modelli di partenza c’è la pagina di Softr.

Make, Zapier o n8n: quale scegliere

Tutti e tre fanno la stessa cosa di base: collegano app e servizi con blocchi invece che con il codice. Cambia come si misura l’uso e quanto lavoro ti chiede il primo mese.

Nella pagina prezzi di Zapier il piano gratuito elenca le automazioni a due passaggi, mentre quello Professional elenca le automazioni a più passaggi e i webhook. Per n8n i piani cloud includono utenti e flussi illimitati e il costo dipende dalle esecuzioni al mese (pagina prezzi di n8n). La versione self-hosted, cioè installata su un server tuo, richiede di gestire quel server: è un costo di messa in piedi che nella tabella non compare.

Se vuoi una strada diversa da Zapier e Make, ci sono KonnectzIT in lifetime, AutomatorWP per chi lavora in WordPress e N8Nitro, che propone n8n self-hosted con auto-scaling.

Errori comuni e limiti

• Chiave scritta nel posto sbagliato. In un campo di testo libero o in uno screenshot, può essere letta da altri: usa il keychain.
• Permessi di troppo. Un token con più scopes del necessario fa più danni se finisce nelle mani sbagliate.
• Crediti finiti. Su Make, quando i crediti finiscono gli scenari non continuano a girare finché non ne aggiungi altri.
• Nome di colonna diverso. Se in Airtable la colonna si chiama Email e nel corpo scrivi email, la riga non si crea come speri.
• Servizi che cambiano. Un indirizzo o un permesso modificato dal produttore blocca lo scenario: guarda ogni tanto la cronologia delle esecuzioni.

Domande frequenti su come usare le API senza programmare

Come si usano le API senza saper programmare?

Con uno strumento a blocchi come Make, Zapier o n8n. Scegli un modulo già pronto oppure il modulo HTTP, compili indirizzo, metodo, chiave e dati, ed esegui lo scenario.

Cos’è una chiave API e come si usa?

È un codice che identifica chi chiama il servizio. Lo generi nelle impostazioni del servizio, lo salvi nelle credenziali dello strumento che usi e non lo condividi.

Cos’è un endpoint API?

È l’indirizzo preciso a cui mandi una richiesta. Ogni azione ha il suo: per esempio uno per leggere le righe di una tabella e uno per crearne una.

Qual è la differenza fra API e webhook?

Con l’API sei tu a chiedere i dati o a mandarli. Con il webhook è l’altro servizio a mandarli a un indirizzo che gli hai dato, e lo scenario parte appena arrivano.

Le API sono sicure?

Dipende da come le usi: la chiamata viaggia su https, ma la chiave resta tua responsabilità. Dai solo i permessi che servono, tieni la chiave nelle credenziali e rigenerala se pensi che sia finita in mani sbagliate.

Da dove partire, a seconda di cosa hai

• Se i tuoi dati sono già in Airtable, parti dalla chiamata POST di questa pagina e da un token con un solo permesso.
• Se non sai quale servizio collegare, sfoglia il catalogo di API per automazioni per categoria, valutazione o numero di utenti.
• Se non vuoi gestire un server, resta su Make o su Zapier; n8n da installare in proprio conviene solo se hai chi lo mantiene.