REST API — Crea integrazioni personalizzate
Accesso programmatico completo a FastLinkIt. Crea link, gestisci contatti, invia mailing, accetta pagamenti e altro — tutto dal tuo codice o dai plugin CMS.
API Link e codici QR
Crea, leggi, aggiorna ed elimina link brevi e codici QR in modo programmatico. Imposta short code personalizzati, parametri UTM, colori e logo per il QR, date di scadenza e monitora le statistiche dei click per ogni link — tutto tramite semplici endpoint JSON.
- Operazioni CRUD complete per link e codici QR
- Short code personalizzati con validazione di disponibilità
- Parametri UTM (source, medium, campaign, term, content)
- Personalizzazione del codice QR (colori, logo)
- Endpoint per analitiche e statistiche dei click
- Gestione tag per ogni link
API Contatti e gruppi
Gestisci il tuo database contatti in modo programmatico. Crea contatti con profili completi che includono telefoni, indirizzi, siti web e note. Organizzali in gruppi, aggiungi membri in massa via email e crea automaticamente i contatti mancanti al volo.
- CRUD completo dei contatti con dati nidificati
- Telefoni, indirizzi, siti web e note per contatto
- Gruppi di contatti con gestione membri
- Importazione massiva di membri via email
- Ricerca e paginazione
- Tracciamento bounce e disiscrizione
API Mailing email
Componi e invia campagne email in modo programmatico. Seleziona i destinatari da contatti o gruppi, usa i placeholder per la personalizzazione, accoda i mailing per la consegna e monitora lo stato di consegna per ogni destinatario in tempo reale.
- Crea bozze di mailing con corpo HTML
- Aggiungi destinatari da gruppi e contatti individuali
- Supporto placeholder (Name, Email, FirstName, LastName, Company)
- Coda per invio in background
- Tracciamento consegna per destinatario
- Filtraggio automatico bounce e disiscritti
API Organizer
Gestisci planner (pagine di prenotazione), template di evento, slot di disponibilità e prenotazioni tramite l'API. Crea workflow di pianificazione personalizzati, sincronizza con calendari esterni o integra le funzionalità di booking nelle tue applicazioni.
- CRUD planner (pagine di prenotazione con short code)
- Gestione dei template di evento
- Creazione batch di slot di disponibilità
- Gestione prenotazioni con aggiornamenti di stato
- Stati confermato, annullato e in attesa
- Soft delete con possibilità di ripristino
API Payment
Accetta pagamenti tramite destination charges di Stripe Connect. Crea prodotti, genera sessioni di checkout, monitora le transazioni ed effettua rimborsi — tutto in modo programmatico. Le notifiche webhook con firma HMAC mantengono i tuoi sistemi sincronizzati.
- Gestione prodotti con prezzi
- Quick checkout (senza prodotto pre-creato)
- Stripe destination charges sul tuo account collegato
- Rimborsi totali e parziali
- Consegna webhook con verifica della firma HMAC
- Tracciamento della sorgente per piattaforma
API GeoIP Lookup
Cerca i dati di posizione geografica di qualsiasi indirizzo IP. Ottieni dettagli completi che includono continente, paese, città, coordinate, ISP, tipo di connessione e fuso orario. I risultati vengono memorizzati nel database per ricerche ripetute più veloci.
- Endpoint di lookup completo e semplificato
- Cerca l'IP del chiamante con /me
- Risoluzione di continente, paese e città
- Coordinate e fuso orario
- Rilevamento di ISP e tipo di connessione
- Identificazione dei paesi UE
API Key con scope
Genera API key con permessi granulari. Seleziona esattamente a quali servizi può accedere ogni chiave — link, contatti, mailing, pagamenti e altro. Segui il principio del minimo privilegio senza rinunciare alle funzionalità.
- 10 scope configurabili (link, QR, contatti, gruppi, mailing, ecc.)
- Accesso completo o ristretto per chiave
- Date di scadenza per chiave
- Tracciamento dell'utilizzo (timestamp ultimo uso)
- Revoca in qualsiasi momento con effetto immediato
- Applicazione degli accessi in base al piano
Autenticazione
Tre metodi di autenticazione per ogni scenario di integrazione. Usa i token JWT Bearer per la comunicazione server-to-server, le API key tramite l'header X-Api-Key per integrazioni semplici o l'autenticazione cookie per la UI web.
- Token JWT Bearer (login con credenziali)
- Autenticazione API Key tramite header X-Api-Key
- Documentazione OpenAPI interattiva (Scalar UI)
- Limiti di utilizzo per piano applicati su tutti gli endpoint
- Supporto CORS per integrazioni browser-based
Domande frequenti
Tutto quello che devi sapere sulla REST API di FastLinkIt.
Quali metodi di autenticazione supporta l'API?
FastLinkIt supporta tre metodi di autenticazione: token JWT Bearer per integrazioni server-to-server, API key tramite l'header X-Api-Key per accesso programmatico semplice e autenticazione cookie per la UI web. I token JWT si ottengono inviando le credenziali all'endpoint /api/auth/login. Le API key vengono generate dalle impostazioni del tuo account.
Come creo un'API key?
Vai su Account > API Keys nella dashboard di FastLinkIt. Clicca
"Genera nuova chiave", dalle un nome e una data di scadenza opzionale, poi seleziona
quali scope (permessi) deve avere la chiave. La chiave grezza viene mostrata una sola
volta — copiala subito. Le chiavi usano il prefisso fli_ per facile identificazione.
Cosa sono gli scope delle API key?
Gli scope ti permettono di limitare cosa può fare ogni API key. Ci sono 10 scope configurabili che coprono link, codici QR, contatti, gruppi, mailing, organizer, pagamenti, GeoIP, file e tag. Puoi concedere accesso completo o limitare una chiave solo ai servizi che le servono, seguendo il principio del minimo privilegio.
C'è un rate limit?
L'utilizzo dell'API è governato dal tuo piano di abbonamento. Ogni piano definisce limiti mensili per la creazione di link e codici QR, dimensioni dei file caricati e quote di archiviazione. L'API applica gli stessi limiti, quindi un piano Starter consente 10 link al mese sia che vengano creati dalla dashboard sia dall'API.
Quali piani includono l'accesso API?
L'accesso API è disponibile su tutti i piani. Gli utenti del piano gratuito possono creare fino a 5 link al mese tramite l'API. I piani superiori sbloccano più capacità di link, upload di file più grandi, archiviazione aggiuntiva e funzionalità avanzate come contatti, mailing e organizer.
Dove trovo la documentazione completa dell'API?
La documentazione interattiva completa dell'API è disponibile tramite la
UI Scalar all'indirizzo /scalar/v1 sulla tua istanza
FastLinkIt. La specifica OpenAPI è pubblicata su /openapi/v1.json,
che puoi importare in Postman, Insomnia o qualsiasi strumento compatibile con OpenAPI.
Posso accettare pagamenti tramite l'API?
Sì. L'API Payment ti permette di creare prodotti, generare sessioni di Stripe Checkout con destination charges, monitorare le transazioni ed effettuare rimborsi totali o parziali. I pagamenti passano attraverso Stripe Connect, quindi i fondi vanno direttamente sul tuo account Stripe collegato con una commissione di piattaforma configurabile. Le notifiche webhook con firma HMAC mantengono i tuoi sistemi sincronizzati.
Inizia a costruire con l'API oggi
Crea il tuo account gratuito in pochi secondi. Nessuna carta di credito richiesta.
Genera un'API key, esplora la documentazione interattiva e rilascia la tua prima integrazione.