L’API de Kolinea : vos outils travaillent dans vos dossiers
Ce que vous faites depuis l’API
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
Brancher l’API, étape par étape
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.
Pour chaque domaine (dossiers, intervenants, fil, demandes, documents, contacts…), choisissez Aucun, Lecture ou Écriture.
Donnez la clé à l’outil qui doit s’en servir : il l’envoie dans l’en-tête Authorization: Bearer de chaque appel.
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 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. Le détail des points d’accès propres au dossier est sur la page API et intégrations.
Ce que l’intégration ne fait pas
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.
Les fonctionnalités en jeu
Vos questions avant de brancher
Une autre question ? Contactez-nous
Elle 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. La spécification OpenAPI 3.1 se télécharge sur /v1/openapi.json, pour générer un client ou l’importer dans Postman.
Oui. Ce qu’une clé publie dans un fil porte le nom que vous lui avez donné, marqué « Intégration ».
Un POST qui porte l’en-tête Idempotency-Key n’est exécuté qu’une fois : pendant 24 heures, une nouvelle tentative avec le même corps reçoit la réponse déjà donnée.
Supprimez sa clé : l’outil perd l’accès aussitôt. Une clé cesse aussi de fonctionner dès que le membre qui l’a créée quitte l’espace.
Les autres intégrations
Votre prochain dossier, sans rien perdre en route
Pas le bon moment ?
Recevez le lien par e-mail et reprenez plus tard, depuis votre ordinateur.
Un seul e-mail, et votre adresse n’est pas conservée.