Vue d'ensemble de l'API
Ce que l'API REST de Deltia permet, ce qu'une clé voit, et comment elle est limitée
À quoi sert l'API
L'API REST de Deltia permet à un outil externe — un script, Make, n8n, Zapier, Power BI — de lire et d'écrire les données de votre espace sans passer par l'interface. Elle couvre :
- le CRM : lister les entités, lire, créer et modifier des fiches, télécharger leurs fichiers ;
- la facturation, en lecture : factures, devis, leurs PDF et les entités légales émettrices.
Chaque espace a sa propre adresse. Toutes les URL de ce guide partent de :
https://<votre-espace>.deltia.co/api/v1Ce qu'une clé voit
Un outil s'authentifie avec une clé API, créée par un administrateur depuis l'écran « Clés API ». Une clé porte quatre choses, figées à sa création :
- ses périmètres : la clé ne voit que les fiches et les documents de ces périmètres, exactement comme un utilisateur qui en serait membre ;
- ses rôles, facultatifs : ils lui ouvrent les entités et les champs CRM réservés à ces rôles ;
- sa matrice CRM : pour chaque entité, les verbes accordés parmi
read,createetupdate; - son droit de lecture sur la facturation, accordé séparément pour les devis et pour les factures. Les entités légales sont lisibles dès que l'un des deux l'est.
Ce que la clé ne voit pas n'existe pas pour elle. Une entité absente de sa
matrice, une fiche hors de ses périmètres, un champ réservé à des rôles qu'elle n'a pas :
l'API répond 404 ou omet le champ, jamais 403. Un 403 confirmerait que la
ressource est là.
Pour changer les accès d'une clé, on en crée une nouvelle puis on révoque l'ancienne : une clé n'est jamais modifiée après coup, seuls son nom et sa date d'expiration peuvent l'être.
Quota
Chaque clé dispose de son propre quota : 60 requêtes par minute par défaut,
réglable par organisation. Une intégration bavarde n'épuise donc pas le quota
des autres. Chaque réponse annonce l'état du quota dans ses en-têtes
(voir Premier appel) ; au-delà, l'API répond
429 rate-limited.