API REST e chiavi API (integrazioni)
Integra il CRM con altri sistemi tramite un'API REST, autenticata da chiave.
Sellio espone un'API REST perché tu possa leggere e scrivere record da altri sistemi (Zapier, Make, i tuoi script, ecc.). L'accesso è autenticato da una chiave API che generi in Impostazioni → API e chiavi.
Genera una chiave
- Vai in Impostazioni → API e chiavi.
- Dai un nome (ad es. "Integrazione Zapier") e clicca su "Genera chiave".
- Copia la chiave SUBITO: appare una sola volta e non può essere recuperata in seguito.
- Per disattivare un'integrazione, usa "Revoca", e la chiave smette di funzionare immediatamente.
Endpoint
- GET /api/v1/{object}: elenca i record (parametri: limit, offset, search).
- GET /api/v1/{object}/{id}: un singolo record.
- POST /api/v1/{object}: crea un record (corpo JSON con i campi).
- PATCH /api/v1/{object}/{id}: aggiorna i campi di un record.
Invia la chiave nell'header Authorization: Bearer sk_live_… {object} è l'API Name dell'oggetto (contact, company, lead, opportunity o uno dei tuoi oggetti personalizzati).
Limite di frequenza e utilizzo (SLA)
Ogni chiave ha un limite di richieste al minuto (predefinito 120), regolabile direttamente nell'elenco delle chiavi. Ogni risposta porta gli header X-RateLimit-Limit (il tetto), X-RateLimit-Remaining (quante rientrano ancora nella finestra attuale) e X-RateLimit-Reset (il momento, in epoch, in cui la finestra si azzera).
Quando superi il limite, l'API risponde 429 (Too Many Requests) con l'header Retry-After che indica quanti secondi attendere prima di riprovare. La schermata delle chiavi mostra anche il totale delle richieste già effettuate da ciascuna chiave (metrica di utilizzo).