Créer un identifiant d'API personnel

Mis à jour le S'applique à : Tous les forfaits
Read in English

Un identifiant d'API personnel permet à vos propres scripts et outils de travailler avec Finaxis en votre nom : un tableur qui lit l'âge de vos comptes, un script qui ajoute des notes à vos clients. Il ne dépasse jamais les droits de votre rôle, il cesse de fonctionner si vous quittez l'instance, et ce qu'il écrit porte votre nom.

Avant de commencer

  • Chaque membre peut créer ses identifiants personnels. Pour un système qui appartient à l'entreprise, un administrateur crée plutôt un compte de service.
  • Pour connecter un assistant IA comme Claude ou ChatGPT, vous n'avez pas besoin d'identifiant : consultez Connecter un assistant IA à Finaxis.

Créer l'identifiant

  1. En haut à droite, cliquez sur votre nom, puis sur Mon profil.
  2. Dans le menu de gauche, sous le nom de votre instance, cliquez sur API.
  3. Sous Mes identifiants d'API, cliquez sur Nouvel identifiant.
  4. Inscrivez un Nom et cochez les Portées. Vous ne pouvez donner à un identifiant que ce que votre rôle permet.
  5. Cliquez sur Créer, et confirmez votre mot de passe si Finaxis le demande.
  6. Sous Votre nouveau secret, copiez le client_id et le client_secret, puis cliquez sur Je l'ai copié.
Mon profil, API, avec la section Mes identifiants d'API et son bouton Nouvel identifiant, puis les sections Applications connectées, Webhooks et Journal des requêtes.
La fenêtre Votre nouveau secret avec les champs client_id et client_secret, chacun avec un bouton de copie, et le bouton Je l'ai copié. Les valeurs sont masquées sur cette image.

À noter : Finaxis affiche le secret une seule fois. Si vous le perdez, faites une rotation du secret.

À noter : Bonne pratique : créez un identifiant par script ou par outil, et n'en réutilisez jamais un pour deux. Vous pouvez alors suivre chacun dans le journal des requêtes, et faire une rotation ou le révoquer sans couper les autres.

Ce qu'un identifiant personnel peut faire

  • Il a les mêmes portées qu'un compte de service, décrites dans Créer un compte de service, dans les limites de votre rôle.
  • Ce qu'il écrit est identifié par votre nom suivi de via API, par exemple Nova via API, dans le journal d'activité et sur la fiche du client.
  • Il cesse de fonctionner si vous quittez l'instance.
  • Les administrateurs voient les identifiants personnels de tous les membres dans Paramètres, puis API, sous Identifiants personnels des membres, et peuvent les révoquer.

Utiliser l'identifiant

Votre script échange le client_id et le secret contre un jeton d'accès, valide une heure, puis appelle l'API à l'adresse https://api.finaxis.ai. La documentation de l'API, en anglais, décrit chaque appel avec des exemples : api.finaxis.ai/docs.

Dépannage

Situation Quoi faire
L'API refuse un appel faute de droits Un identifiant personnel reste dans les limites de votre rôle. Demandez le droit à un administrateur, ou un compte de service.
L'identifiant a cessé de fonctionner Son secret a expiré ou a été remplacé, un administrateur l'a révoqué, ou vous avez quitté l'instance. Vérifiez la liste Secrets sur sa ligne.

Besoin d'aide avec votre script? Écrivez à support@finaxis.ai avec l'identifiant de requête de l'appel, et notre équipe vous aidera.

Articles liés

Vous ne trouvez pas ce que vous cherchez?

Notre équipe de soutien est là pour vous aider.