- Home
- Integrazioni
- API REST
API REST
L’API REST completa per automatizzare tutti i tuoi link e codici QR
Ogni schermata di TinyLink ha le sue rotte: link brevi, UTM, programmazione, codici QR, pagine, componenti, tag e statistiche. I tuoi script, il tuo CRM e i tuoi scenari Make, Zapier o n8n creano con una richiesta ciò che prima richiedeva dieci clic. La documentazione fornisce un esempio di richiesta e di risposta per ogni rotta.
API inclusa dal piano Pro, a 29 € IVA esclusa al mese, senza vincoli. Gratis per iniziare, senza carta di credito.
Quanto costano i link fatti a mano
Copiare l’indirizzo, comporre gli UTM, accorciare, generare il codice QR, scaricarlo, archiviarlo: conta due minuti per link. Su un catalogo di 300 prodotti, è una giornata intera, da rifare a ogni campagna. E basta un refuso in un utm_campaign per spezzare in due le tue statistiche.
Una rotta per ogni gesto
Quello che fai nella dashboard, lo fa anche l’API, con le stesse regole e gli stessi limiti del tuo piano. Una sola richiesta POST /v1/links crea il link breve, i suoi UTM, la data di fine e il codice QR dinamico. Per reagire quando un link scade, aggiungi avvisi automatici via webhook; per creare link da una conversazione, il server MCP ufficiale per Claude.
- Link brevi: indirizzo personalizzato, UTM, modelli UTM condivisi, programmazione e numero massimo di clic
- Codici QR dinamici: creati con il link, con o senza logo, o dai tuoi modelli
- Pagine e componenti: creare, modificare e duplicare una pagina, e aggiungervi i tuoi blocchi
- Statistiche: clic al giorno, provenienza, paesi e dispositivi, da 1 a 90 giorni o dalla creazione
Token sotto controllo
Un token per spazio, con i suoi permessi: lettura, scrittura, eliminazione. Apre solo lo spazio in cui è stato generato, è conservato cifrato da noi e si rigenera o si revoca con un clic. Ogni risposta indica le richieste rimaste nel minuto (120 per token): i tuoi script sanno quando rallentare.
Ospitata in Francia, pronta per i tuoi clienti
L’API, i tuoi link e le statistiche dei tuoi visitatori restano su server francesi. Con il piano Business, ogni cliente dell’agenzia ha il proprio spazio e il proprio token: uno script configurato male per uno non tocca mai i link dell’altro. Gli errori arrivano in JSON, con un codice e il campo in questione.
Un catalogo di 300 prodotti, con link e codici QR in pochi minuti
Un negozio online prepara le etichette da scaffale. Il suo script scorre il catalogo e chiama POST /v1/links per ogni scheda prodotto: link breve con il suo nome, UTM «negozio», codice QR creato nella stessa richiesta. Meno di tre minuti dopo, al ritmo di 120 richieste al minuto, i 300 codici QR sono pronti da stampare, e ogni scansione compare nelle statistiche, prodotto per prodotto.
Domande frequenti
Da quale piano è disponibile l’API?
Dal piano Pro, a 29 € IVA esclusa al mese, senza vincoli, con 5 spazi di lavoro. Il piano Business, a 79 € IVA esclusa al mese, arriva fino a 25, ognuno con il proprio token.
Quali linguaggi e strumenti posso usare?
Tutti quelli che sanno inviare una richiesta HTTPS con un’intestazione Authorization: Python, PHP, JavaScript, curl, ma anche il modulo di richiesta HTTP di Make, Zapier o n8n. Le risposte sono in JSON.
C’è un limite di richieste?
120 richieste al minuto per token. Ogni risposta porta le intestazioni X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset; oltre il limite, l’API risponde 429 con il tempo di attesa. I limiti del tuo piano (pagine, link) valgono come nella dashboard.
I miei dati e i miei token sono al sicuro?
I tuoi dati sono ospitati in Francia e si applica il GDPR. Ogni token apre solo il suo spazio, con i permessi che scegli; è conservato cifrato e si revoca in qualsiasi momento. Il pannello del token mostra la data dell’ultima chiamata e il numero di chiamate.
Link creati dai tuoi strumenti, non a mano
Crea il tuo account, passa al piano Pro e genera il tuo token in Libreria ▸ Integrazioni. Il tuo primo link via API sta in una richiesta.