Offrire l'API ai tuoi clienti

I tuoi clienti possono automatizzare i loro link esattamente come tu automatizzi il tuo account partner. Questa pagina è il manuale operativo per trasformare l'API in una funzionalità del tuo prodotto, testo compreso: puoi adattarlo per la documentazione per sviluppatori del tuo servizio.

Come funziona

• I clienti creano le proprie chiavi. Ogni area di lavoro su un piano con accesso all'API ha Impostazioni → Chiavi API nella dashboard brandizzata. Le chiavi appartengono all'area di lavoro: la tua chiave partner non entra mai in gioco e un cliente può raggiungere solo i propri dati.
• L'host è condiviso. Tutte le richieste vanno a https://api.linkprofit.com/v1. Nella v1 non è disponibile un dominio API personalizzato per partner: documenta l'host come l'endpoint tecnico del tuo servizio. Le risposte non portano alcun marchio LinkProfit: domini, link e analytics nei payload sono quelli del tuo cliente.
• Decidi tu chi ne ha diritto. L'accesso all'API è il flag api_access sui piani che vendi. I clienti su piani senza quel flag ricevono 403 plan_restricted: un'occasione di upsell pulita. I limiti di frequenza seguono la chiave, quindi un piano più impegnativo può uscire con un limite più alto.

Cosa mettere nella tua documentazione

A una pagina minima per gli sviluppatori dei tuoi clienti servono quattro cose:

1. Dove stanno le chiavi — «Impostazioni → Chiavi API nella tua dashboard; la chiave viene mostrata una sola volta».
2. L'URL di base — https://api.linkprofit.com/v1, autenticazione con Authorization: Bearer <key>.
3. Una guida rapida — copia la Guida rapida e sostituisci il dominio d'esempio con uno dei tuoi.
4. Il riferimento — rimanda al riferimento interattivo oppure ospita il file OpenAPI (https://linkprofit.com/openapi.json) nel tuo strumento di documentazione: si visualizza così com'è in Scalar, Swagger UI, Redoc e Postman.

Webhook per i clienti

Le aree di lavoro dei clienti registrano i propri endpoint webhook per gli eventi di link, dominio e soglia di clic. Gli eventi di livello partner — abbonamenti, pagamenti — restano sui tuoi endpoint partner e non vengono mai consegnati ai clienti.

Limiti da tenere presenti

• Le chiavi sono per area di lavoro: un cliente-agenzia che gestisce più aree di lavoro crea una chiave in ciascuna.
• Il log di audit attribuisce le modifiche via API alla chiave ed è visibile al cliente nella sua dashboard: le conversazioni con l'assistenza partono dai fatti.
• Tutto ciò che l'API scrive rispetta le stesse quote di piano della dashboard: un cliente non può superare via script il limite di link che gli hai venduto.