Comment ça marche
L'API REST sous /api/v1 couvre les accords, les entités, les contacts, les documents, les fiches d'objets personnalisés, les utilisateurs et les Groupes. Les clients API se créent dans les paramètres d'Interopérabilité et s'authentifient avec OAuth ou une clé d'API. Par exemple, une commande émise dans votre ERP ou une embauche saisie dans votre SIRH peut appeler l'API pour créer l'Accord correspondant, avec ses champs déjà renseignés.
Chaque client reçoit des périmètres par ressource, comme agreements:read, entities:write ou documents:write, ou des jokers. Les écritures acceptent une clé d'idempotence : un appel rejoué n'est pas appliqué deux fois.
Les fiches peuvent être adressées par leur identifiant Formality ou par votre propre identifiant, écrit external:{system}:{id}. Votre ERP ou votre outil d'achats n'a donc pas besoin de stocker les identifiants Formality. Combinée aux webhooks sortants, cette fonction donne une synchronisation bidirectionnelle.
Ce que vous obtenez
- Accords, entités, contacts et documents
- Périmètres de lecture et d'écriture par ressource
- Vos identifiants externes sur chaque fiche
- Utilisable avec les webhooks pour une synchronisation bidirectionnelle
Pourquoi les équipes l'utilisent
Créez les Accords et les fournisseurs depuis les outils où ils naissent.
Donnez à chaque intégration uniquement les périmètres dont elle a besoin.
Adressez les fiches avec les identifiants de votre ERP ou de votre portail.
Les clés d'idempotence empêchent un appel rejoué de créer des doublons.
Chaque appel apparaît dans le journal des appels API.
Plus dans Intégrations & API
Serveur MCP et API pour Agents IA
Connectez Claude, ChatGPT ou Copilot à vos contrats, dans le respect de vos règles.
En savoir plus →Webhooks sortants
Formality prévient vos systèmes quand quelque chose change.
En savoir plus →Microsoft Teams
Notifications et rappels dans Teams.
En savoir plus →Slack
Notifications et rappels dans Slack.
En savoir plus →