Panoramica dell'API

Tutto quello che fa la dashboard lo fa anche l'API: creare link con targeting e split A/B, leggere le analytics, collegare domini, gestire clienti e piani. L'API è una superficie di prodotto di prima classe: la dashboard e l'API eseguono lo stesso codice e applicano gli stessi limiti.

URL di base

https://api.linkprofit.com/v1

Tutte le richieste usano HTTPS e JSON. Le risposte sono in JSON, tranne l'immagine del QR e l'esportazione CSV. Il riferimento interattivo, sempre aggiornato, si trova su /docs/api/reference ed è generato dagli stessi schemi che validano ogni richiesta.

Due tipi di chiave

| Prefisso della chiave | Ambito | Si crea in | Dà accesso a | |---|---|---|---| | lp_live_… | Area di lavoro | Impostazioni dell'area di lavoro → Chiavi API | /links, /analytics, /domains, /workspace, /events, /webhooks | | lpp_live_… | Partner | Impostazioni del partner → Chiavi API | /partner/* e /webhooks |

Una chiave di area di lavoro agisce dentro una sola area di lavoro cliente. Una chiave partner gestisce l'account partner: clienti, piani, domini, pagamenti. Le chiavi portano con sé degli ambiti che limitano ciò che ciascuna può fare.

Versionamento

La v1 è congelata: i campi vengono solo aggiunti, mai rinominati o rimossi. Le modifiche incompatibili uscirebbero come /v2. Sviluppa sui campi documentati e ignora quelli sconosciuti.

White label: offrire l'API ai tuoi clienti

Se gestisci un servizio di link white label, l'API fa parte di ciò che rivendi:

• Le chiavi le distribuisci tu. Ogni cliente crea le proprie chiavi di area di lavoro nella dashboard con il suo marchio (Impostazioni → Chiavi API): la tua chiave partner non viene mai condivisa.
• L'host resta condiviso. Nella v1 tutto il traffico dell'API va a api.linkprofit.com: un dominio API personalizzato per partner non è ancora disponibile. Documenta l'URL di base come «l'host API del tuo servizio»; le risposte non contengono alcun marchio LinkProfit.
• I limiti seguono i tuoi piani. L'accesso all'API è un flag di funzionalità sui piani che vendi (api_access) e il limite di frequenza di ogni chiave deriva dal piano. Un cliente su un piano senza accesso all'API riceve 403 plan_restricted.

Consulta la guida white label per una pagina pronta da copiare e adattare alla documentazione per sviluppatori del tuo servizio.

Riferimenti rapidi

• Guida rapida — crea un link in due minuti.
• Autenticazione — chiavi, ambiti, rotazione delle chiavi.
• Paginazione — cursori su ogni endpoint di elenco.
• Errori — il formato unico di errore e tutti i codici.
• Limiti di frequenza — finestra scorrevole, header, nuovi tentativi.
• Webhook — consegne di eventi firmate e con tentativi ripetuti.