API REST et clés API (intégrations)
Intégrez le CRM à d'autres systèmes via une API REST, authentifiée par clé.
Sellio expose une API REST pour lire et écrire des enregistrements depuis d'autres systèmes (Zapier, Make, vos propres scripts, etc.). L'accès est authentifié par une clé API que vous générez dans Paramètres → API et clés.
Générer une clé
- Allez dans Paramètres → API et clés.
- Donnez-lui un nom (par ex. « Intégration Zapier ») et cliquez sur « Générer une clé ».
- Copiez la clé IMMÉDIATEMENT : elle n'apparaît qu'une seule fois et ne peut plus être récupérée par la suite.
- Pour désactiver une intégration, utilisez « Révoquer », et la clé cesse de fonctionner immédiatement.
Points de terminaison
- GET /api/v1/{object} : liste les enregistrements (paramètres : limit, offset, search).
- GET /api/v1/{object}/{id} : un enregistrement unique.
- POST /api/v1/{object} : crée un enregistrement (corps JSON avec les champs).
- PATCH /api/v1/{object}/{id} : met à jour les champs d'un enregistrement.
Envoyez la clé dans l'en-tête Authorization: Bearer sk_live_… Le {object} est le Nom API de l'objet (contact, company, lead, opportunity ou l'un de vos objets personnalisés).
Limite de débit et usage (SLA)
Chaque clé a une limite de requêtes par minute (120 par défaut), ajustable directement dans la liste des clés. Chaque réponse comporte les en-têtes X-RateLimit-Limit (le plafond), X-RateLimit-Remaining (combien tiennent encore dans la fenêtre actuelle) et X-RateLimit-Reset (le moment, en epoch, où la fenêtre se réinitialise).
Lorsque vous dépassez la limite, l'API répond 429 (Too Many Requests) avec l'en-tête Retry-After indiquant combien de secondes attendre avant de réessayer. L'écran des clés affiche aussi le total des requêtes déjà effectuées par chaque clé (mesure d'usage).