Aller au contenu

API et webhooks

Mis à jour:

Clés API avec durée de validité et liste d'IP, webhooks et flux BI sous Paramètres → Intégrations & API.

Ouvrir Paramètres dans Fiatto
Dans cet article

En plus du SSO/SCIM et de la connexion comptable, Fiatto propose une API REST, des webhooks et un flux BI. Les administrateurs les gèrent sous Paramètres → Intégrations & API (/dashboard/settings/integraties).

Étapes

  1. Ouvrez Paramètres (menu du compte) → carte Intégrations & API.
  2. Créez une clé dans Clés API : saisissez un nom, choisissez la Durée de validité (30, 90 ou 180 jours ou 1 an) et, si besoin, renseignez les Adresses IP autorisées (une adresse ou une plage CIDR par ligne). Cliquez sur Créer une clé et copiez-la tout de suite : vous ne la verrez qu'une fois. Dans le sandbox, la clé porte _test_ dans son nom et ne fonctionne que sur l'environnement d'essai.
  3. Limitez les droits. Une clé API (scope api) fonctionne sur /api/v1 : lecture et écriture des demandes d'achat, factures d'achat, contrats, fournisseurs et programmes ; lecture et création des clients et des commandes de vente ; lecture et dépôt des tickets juridiques ; lecture seule pour les factures et contrats de vente, bons de commande, réceptions et paiements. Une commande de vente créée via l'API arrive en brouillon, avec les mêmes contrôles qu'à l'écran (comme la limite de crédit) et une Idempotency-Key obligatoire. Les transmissions fixes entre modules se lisent sous forme de flux sur /api/v1/handovers. Le grand livre (écritures et balance générale) et la piste d'audit pour un SIEM s'activent séparément par clé ; seul un approbateur ou un comptable peut accorder l'accès au grand livre. Une clé du Connecteur BI (Power BI / Excel) a le scope bi.read et ne fonctionne que sur le flux OData en lecture seule.
  4. Ajoutez un endpoint sous Webhooks, choisissez les événements et envoyez un événement de test ; les livraisons échouées figurent dans le journal de livraison. Renouveler le secret crée un nouveau secret de signature ; l'ancien reste valable 24 heures. Pour chaque endpoint, vous choisissez le Format des messages : Fiatto (par défaut) ou CloudEvents 1.0 (la norme ouverte ; une transmission arrive alors exactement comme dans le flux). La liste des événements comprend aussi les transmissions (handover.*) et le cycle de vie des contrats, comme contract.created, contract.status_changed, contract.renewed et contract.expired.

Conseils

  • N'utilisez jamais de clés API dans un navigateur ou une application mobile. Une clé ne se prolonge pas : créez-en une nouvelle, mettez-la dans votre intégration et révoquez l'ancienne. Les administrateurs et le créateur reçoivent un rappel 14 et 3 jours avant ; une clé inutilisée pendant 90 jours est révoquée automatiquement après un avertissement. Une liste d'IP ne peut ensuite qu'être réduite (Restreindre la liste IP). Pour chaque clé API, BI et d'assistant, vous voyez quand et depuis quelle adresse elle a été utilisée en dernier ; si elle n'a pas encore de liste d'IP, Restreindre à cette adresse la limite à cette adresse en un clic.
  • Chaque clé a par défaut une limite de 120 requêtes par minute ; lisez les en-têtes X-RateLimit-* pour ralentir avant un 429. La politique de versions figure dans /api/v1/openapi.json et dans les en-têtes Deprecation/Sunset : une version est annoncée au moins 12 mois à l'avance.
  • Un SIEM peut abonner un endpoint webhook à l'événement des événements de sécurité (connexions, validation en deux étapes, changements de rôles et de politique, bouton d'urgence, accès support).
  • Dans la sandbox, chaque endpoint webhook est un endpoint de test : chaque livraison porte l'en-tête X-Fiatto-Environment: test (live dans votre environnement réel), et les clés API et webhooks de test sont conservés lorsque vous videz la sandbox. Voir s'entraîner dans la sandbox.
  • Toutes les intégrations avec leur statut, les apps tierces et le portail développeur se trouvent sous Paramètres → Intégrations & apps (marketplace) (/dashboard/settings/koppelingen). Connecter Claude ou ChatGPT : assistants IA externes. Emporter vos données sans API : export des données.
Cet article vous a-t-il été utile ?
Voir tous les articles de ce thème

Trouver une autre réponse

Une tâche, une fonctionnalité ou une courte question suffit.