API Développeurs Admin
Intégrez Kaltiv avec vos outils existants via l'API REST publique.
Documentation complète
La documentation technique détaillée est disponible à l'adresse :
/developer/api-docs — Référence complète des endpoints, authentification et exemples (accessible depuis le SaaS).
Clés API
Créer une clé
- Menu latéral → Paramètres → Clés API (
/settings/api-keys) - Cliquez sur Nouvelle clé
- Donnez un nom descriptif (ex: « Intégration comptable »)
- Sélectionnez les scopes (permissions) nécessaires
- Définissez la limite de requêtes par minute
- Cliquez sur Créer la clé
Important
La clé complète n'est affichée qu'une seule fois à la création. Copiez-la immédiatement et stockez-la en lieu sûr.
Scopes disponibles
| Scope | Description | Méthodes |
|---|---|---|
employees:read | Lire les données employés | GET |
products:read | Lire le catalogue produits | GET |
orders:read | Lire les commandes | GET |
orders:write | Créer/modifier des commandes | GET, POST, PUT |
invoices:read | Lire les factures | GET |
customers:read | Lire les données clients | GET |
agriculture:read | Lire les données agricoles | GET |
Révoquer une clé
- Allez dans Paramètres → Clés API
- Cliquez sur l'icône de suppression (🗑️) de la clé concernée
- Confirmez la révocation
La clé est immédiatement désactivée. Les intégrations qui l'utilisent cesseront de fonctionner.
Authentification
Incluez votre clé dans l'en-tête HTTP de chaque requête :
Authorization: Bearer tk_votre_cle_ici
Limites de requêtes
- Par défaut : 100 requêtes/minute par clé
- Configurable : 1 à 1 000 requêtes/minute
- Les en-têtes de réponse indiquent votre consommation :
X-RateLimit-Remaining
Cas d'usage courants
| Intégration | Scopes nécessaires |
|---|---|
| Logiciel comptable | invoices:read, orders:read |
| Site e-commerce | products:read, orders:write, customers:read |
| Tableau de bord BI | employees:read, agriculture:read |
| Application mobile | orders:read, customers:read |
Format des réponses
Toutes les réponses sont au format JSON. Les listes sont paginées avec les paramètres page et per_page. Les erreurs suivent le format standard HTTP (400, 401, 403, 404, 429, 500).