# L’API de Kolinea : vos outils travaillent dans vos dossiers

> 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 dans vos autres outils

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 laisse vos outils le faire à votre place. Elle répond en JSON, chaque appel porte la clé de l’espace, et la clé n’obtient que les droits que vous lui avez donnés, domaine par domaine. 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.

## Une clé que vous gardez en main

La clé ne s’affiche qu’une fois, à sa création ; Kolinea n’en garde que l’empreinte. Vous pouvez lui donner une date d’expiration, changer ses droits sans changer la clé (l’outil suit dès son appel suivant), et la supprimer à tout moment.

Les documents qu’elle télécharge apparaissent dans le journal d’accès du dossier, sous son nom. Ce qu’elle publie porte la mention « Intégration » : vos clients savent que le message vient d’une application, pas d’une personne.

## Ce que l’API sait faire d’un dossier

Au-delà de l’ouverture et de la publication, quelques points d’accès servent à conserver la preuve ou à enchaîner un dossier sur le suivant. Un dossier se duplique pour l’année suivante, avec les intervenants que vous gardez et ses champs, remplis ou vides ; personne n’en est prévenu. L’attestation d’un bon pour accord se télécharge dès la première réponse, et le registre de clôture d’un dossier clos se télécharge au format PDF : la page [Vérifier un document](/fr/features/verifier-un-document) reconnaît l’un comme l’autre.

## Une documentation générée par le produit

La documentation de l’API est produite à partir du code de Kolinea : elle ne peut pas décrire une version ancienne de l’API. Chaque point d’accès y figure avec les droits qu’il demande et un exemple de réponse, avec les appels prêts à copier.

Pour être prévenu d’un changement plutôt que d’interroger l’API en boucle, branchez des [webhooks](/fr/integrations/webhooks). Le détail des points d’accès propres au dossier est sur la page [API et intégrations](/fr/features/api-et-integrations).

## Ce que vous pouvez faire

- Ouvrir un dossier, y ajouter un intervenant et y publier une demande ou une demande de documents
- Récupérer un document reçu, lire le fil comme l’équipe, mettre un contact à jour
- Dupliquer un dossier pour l’année ou la session suivante
- Télécharger l’attestation d’un bon pour accord, ou le registre de clôture d’un dossier clos, au format PDF
- Enregistrer un bon pour accord donné ailleurs, en nommant l’intervenant et la façon dont la réponse est arrivée
- Dire qu’une demande est prise en charge, avec une date attendue, et répondre à une demande de délai

## Mise en route

1. Dans les paramètres de votre espace, rubrique Développeurs, 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, documents, contacts…), choisissez Aucun, Lecture ou Écriture.
3. Donnez la clé à l’outil qui doit s’en servir : il l’envoie dans l’en-tête Authorization: Bearer de chaque appel.

## Limites

- Une clé appartient à un espace et n’en sort pas : elle ne voit aucun dossier d’un autre espace.
- Elle ne lit jamais une publication confidentielle adressée à quelqu’un d’autre.
- 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.
- Elle ne donne jamais un bon pour accord à la place de quelqu’un : elle enregistre seulement celui qu’un intervenant a donné ailleurs.
- Au-delà de 120 appels par minute pour un espace, l’API répond 429, avec l’en-tête Retry-After.