Guides
Expédiez rapidement votre premier flux de signature électronique avec Firma : un guide de démarrage pour les développeurs
Vous êtes développeur et vous possédez déjà votre compte Firma ? Parfait. Ce guide vous accompagne de la « clé API en main » jusqu'à un flux de signature intégré et opérationnel. Nous irons droit au but, en nous concentrant sur les décisions clés, et nous vous renverrons directement aux extraits de code fonctionnels dans la documentation.
Vous recherchez le guide non technique ? Cliquez ici.
Ce que vous allez faire
Modéliser le cloisonnement des clients avec les espaces de travail (Workspaces)
Créer un modèle (Template) réutilisable
Envoyer une demande de signature (Signing Request)
Intégrer l'expérience de signature ou configurer une redirection
Tout suivre grâce aux Webhooks
La tarification est simple. C'est €0,029 par enveloppe, testez avec de vrais documents, c'est gratuit pour que vous puissiez concevoir et tester de bout en bout.
Conditions préalables
Une clé API d'entreprise ou d'espace de travail depuis votre tableau de bord
Un PDF que vous pouvez transformer en modèle
Un environnement pour exécuter le code serveur afin de générer les JWT et de gérer les webhooks
Besoin d'un rappel sur le flux général ? Consultez le guide d'installation complet.
1) Créer un espace de travail pour chaque client
Les espaces de travail offrent à chaque client un espace privé et cloisonné avec des modèles, des documents et des volumes d'utilisation isolés. C'est le moyen le plus propre de concevoir une séparation multi-locataire de type SaaS sans fuite de données entre les clients.
Utile : les paramètres de l'espace de travail, comme le modèle d'e-mail et le fuseau horaire, sont configurables par espace de travail.
2) Créer un modèle réutilisable
Les modèles contiennent le PDF ainsi que les rôles et les champs associés, ce qui vous permet d'envoyer le même document plusieurs fois à des destinataires différents.
Option A : Permettre aux utilisateurs de concevoir des modèles dans votre application
Intégrez l'éditeur de modèles à l'aide d'un jeton JWT à durée de vie courte.
Générez le jeton côté serveur.
3) Créer la demande de signature
Transformez votre modèle en une transaction active. Vous pouvez également la créer à partir d'un fichier PDF brut si vous préférez. La documentation de référence couvre les destinataires, les champs, les rappels et les règles de validation.
Optionnel : laisser les utilisateurs professionnels remplir les détails et l'envoyer depuis votre interface
Intégrez l'éditeur de demandes de signature avec un jeton JWT de 7 jours.
Générez le JWT côté serveur.
4) Envoyer la demande de signature
Lorsque vous êtes prêt, déclenchez l'envoi.
5) Proposer la signature au sein de votre produit ou via redirection
Signature intégrée
Chaque destinataire signe sur une URL unique qui suit ce modèle :
https://app.firma.dev/signing/{signing_request_user_id}.
Vous récupérerez l'identifiant signing_request_user_id via l'API.
Signature par redirection
Alternativement, vous pouvez rediriger les destinataires vers l'interface de signature hébergée. Consultez le même guide ci-dessus pour plus de détails.
6) Tout suivre grâce aux webhooks
Soyez à l'écoute d'événements tels que la création, l'envoi, la consultation, la signature et la finalisation pour mettre à jour votre système en temps réel. Le guide comprend la vérification HMAC, la rotation, les tentatives de renvoi et une checklist de mise en production.
Notes rapides sur l'architecture
Les JWTs. Générez-les côté serveur. Les jetons pour l'éditeur de modèles ont une durée de vie courte ; les jetons pour l'éditeur de demandes de signature expirent après 7 jours.
Les espaces de travail pour le SaaS. Maintenez vos clients totalement cloisonnés. Vos opérateurs travaillent toujours à partir d'une seule et même API.
Tarification et déploiement. Commencez par les enveloppes gratuites incluses, puis passez en production. Aucun minimum requis. €0,029 par enveloppe.
Quelle est la prochaine étape ?
Connectez votre premier espace de travail
Ajoutez un modèle
Envoyez votre première demande
Choisissez entre l'intégration et la redirection
Connectez les webhooks
👉 Obtenir la clé API - aucune carte de crédit requise.
Articles connexes
Notre plateforme est conçue pour permettre aux entreprises de toutes tailles de travailler plus intelligemment et d'atteindre leurs objectifs avec confiance.
