API per sviluppatori
Chiavi API, endpoint, limiti di richieste e webhook
9 articoli
L’API di LinkHarbor in sintesi
URL di base, sandbox, versioni, formato dei dati, paginazione e autenticazione: cosa sapere prima della prima chiamata all’API REST di LinkHarbor.
Chiavi API e token di accesso
Crea una chiave API nella dashboard, scegli gli scope, scambiala con un token da 15 minuti, custodiscila al sicuro e revocala quando serve, passo dopo passo.
Scope: tutte le autorizzazioni dell’API
Tutti i 15 scope per chiavi API e connessioni AI: cosa consente ogni scope, come si chiama nella dashboard e cosa nessuna chiave API può fare.
Endpoint dell’API per area
Tutti gli endpoint che puoi usare con una chiave API, ordinati per area, con metodo, percorso, scope richiesto e funzione.
Limiti di richieste: tutti i limiti e header
Quante richieste al minuto consente l’API di LinkHarbor, quanto può essere grande una richiesta, come leggere gli header e gestire bene un 429.
Formato degli errori e codici di errore API
Come sono strutturate le risposte di errore dell’API di LinkHarbor, cosa significano i codici di errore principali e come deve reagire il tuo codice.
Webhook: eventi, payload e firma
Configura i webhook nella dashboard, ricevi le consegne e verifica la firma HMAC, con esempi per curl, Node.js e PHP.
Inviare vendite e dati propri a LinkHarbor
Con i callback di vendita associ le vendite del tuo shop ai clic sui link, con «Custom (API)» invii alla tua pagina dati live dai tuoi strumenti.
Passo per passo: aggiornare una pagina via API
Dalla chiave API alla versione pubblicata: aggiungi un link, spostalo in cima, cambia il design, valida la bozza e pubblica, con curl e jq.