# Reliez Kolinea à vos outils par l’API

> Une clé par espace, des droits choisis domaine par domaine, et une documentation générée à partir du produit lui-même.

## Vos dossiers vivent aussi ailleurs

Un devis part de votre logiciel de gestion, un rendez-vous de votre agenda, une fiche client de votre CRM. Recopier ces informations à la main dans chaque dossier prend du temps, et c’est là que les erreurs se glissent.

L’API de Kolinea permet à vos outils de le faire à votre place : ouvrir un dossier, y ajouter un intervenant, publier une demande de pièces, récupérer un document reçu ou mettre un contact à jour.

## Une clé, des droits précis

1. Dans les paramètres de votre espace, rubrique Développeurs, vous créez une clé. Elle commence par `kol_live_` et ne s’affiche qu’une seule fois.
2. Pour chaque domaine (dossiers, intervenants, fil, demandes, commentaires, documents, contacts, champs, modèles, membres…), vous choisissez Aucun, Lecture ou Écriture. Une clé qui n’a besoin que de lire ne peut rien modifier, et une clé qui publie des demandes n’a pas pour autant le droit d’y répondre.
3. Vous donnez la clé à l’outil qui doit s’en servir : votre logiciel métier, un automate capable d’appeler une API, ou votre propre code.

Vous pouvez donner une date d’expiration à une clé, changer ses droits sans changer la clé (l’outil suit dès son appel suivant), et la supprimer à tout moment : l’outil qui l’utilisait perd aussitôt l’accès. Une clé cesse aussi de fonctionner dès que le membre qui l’a créée quitte l’espace.

## Ce qu’une clé peut faire, et ce qu’elle ne fera jamais

- Une clé appartient à un espace et n’en sort pas : elle ne voit aucun dossier d’un autre espace.
- Elle lit le fil comme l’équipe, notes internes comprises, mais jamais une publication confidentielle adressée à quelqu’un d’autre.
- Les documents qu’elle télécharge apparaissent dans le journal d’accès du dossier, sous son nom.
- Ce qu’elle publie dans un fil porte le nom que vous lui avez donné, marqué « Intégration ». Vos clients savent que le message vient d’une application, pas d’une personne.
- Elle ne supprime pas l’espace, ne change pas l’offre, ne crée pas d’autre clé et ne donne jamais le rôle d’administrateur.

## Prévenu dès que quelque chose bouge

Plutôt que d’interroger l’API en boucle, votre outil peut être prévenu. Dans les paramètres de l’espace, vous donnez l’adresse d’un webhook et choisissez les événements à recevoir : un client a répondu à une demande, une pièce est arrivée, un dossier a été clos… Chaque envoi est signé, et ne contient que des identifiants : votre outil relit le détail avec sa clé, dans la limite de ses droits.

## Une documentation toujours à jour

La documentation de l’API est générée à partir du produit lui-même : chaque point d’accès, les droits qu’il demande, les champs qu’il attend et un exemple de réponse, avec les appels prêts à copier. Elle ne peut pas décrire une version ancienne de l’API. La spécification OpenAPI est aussi téléchargeable, pour générer un client ou l’importer dans Postman.