Ce que nous avons expédié en janvier 2026

Le mois de janvier a u00e9tu00e9 bien occupu00e9. Nous avons du00e9ployu00e9 une su00e9rie de mises u00e0 jour sur Firma.dev qui nous tiennent particuliu00e8rement u00e0 cu0153ur, et la plupart d'entre elles proviennent directement des retours que nous avons reu00e7us des du00e9veloppeurs qui intu00e8grent notre API.

Le thu00e8me de ce mois-ci u00e9tait de rendre l'API plus rapide, plus flexible et plus facile u00e0 intu00e9grer. Certaines de ces modifications sont de petites amu00e9liorations de confort. D'autres ouvrent la voie u00e0 des flux de travail entiu00e8rement nouveaux. Nous en sommes du00e9sormais u00e0 la version 1.2.0, et toutes ces nouveautu00e9s sont disponibles du00e8s aujourd'hui.

Voici le ru00e9capitulatif.

Des demandes de signature 40 % plus rapides

Nous avons passu00e9 quelques semaines u00e0 analyser les performances et nous avons ru00e9ussi u00e0 faire passer notre latence moyenne de demande de signature de 820 ms u00e0 environ 500 ms. Cela repru00e9sente une amu00e9lioration globale d'environ 40 %.

Les changements ont principalement concernu00e9 l'infrastructure. Nous avons optimisu00e9 certaines requu00eates de base de donnu00e9es devenues inefficaces avec le temps, et nous avons placu00e9 les ressources statiques derriu00e8re AWS CloudFront pour un mise en cache pu00e9riphu00e9rique (edge caching). Rien de ru00e9volutionnaire, mais c'est le genre de travail qui finit par payer.

Si vous intu00e9grez des signatures u00e0 votre produit, cela a plus d'importance qu'il n'y parau00eet. 300 ms de latence, cela peut sembler peu, mais c'est la diffu00e9rence entre un parcours de signature instantanu00e9 et un parcours fastidieux. Des ru00e9ponses plus rapides signifient moins de parcours abandonnu00e9s et moins de friction pour vos utilisateurs.

Demandes de signature ponctuelles (sans modu00e8le requis)

Auparavant, si vous vouliez envoyer un document pour signature via Firma.dev, vous deviez d'abord cru00e9er un modu00e8le. Cela faisait sens pour des workflows ru00e9pu00e9titifs comme les contrats de travail ou les accords de confidentialitu00e9 (NDA), mais cela ajoutait des u00e9tapes inutiles pour les documents uniques.

Du00e9sormais, vous pouvez complu00e8tement ignorer le modu00e8le. Tu00e9lu00e9versez directement un PDF, du00e9finissez vos champs et destinataires en ligne, puis envoyez-le. Un seul appel API, aucune cru00e9ation de modu00e8le requise.

C'est idu00e9al pour les accords ad hoc, les contrats uniques ou toute situation ou00f9 vous n'allez pas ru00e9utiliser la structure du document. Vous bu00e9nu00e9ficiez toujours des mu00eames types de champs, options de signataires et suivi. Vous n'avez simplement plus besoin de configurer de modu00e8le au pru00e9alable.

Consultez le point de terminaison (endpoint) de cru00e9ation de demande de signature pour connau00eetre les du00e9tails d'implu00e9mentation.

Point de terminaison atomique Cru00e9er + Envoyer

En parlant de ru00e9duction des appels API : nous avons ajoutu00e9 un nouveau point de terminaison atomique qui vous permet de cru00e9er et d'envoyer une demande de signature en un seul appel.

Auparavant, vous deviez appeler le point de terminaison de cru00e9ation, puis celui d'envoi. Deux requu00eates, deux aller-retours. Le nouveau point de terminaison /signing-requests/create-and-send combine les deux u00e9tapes en une seule.

Mais le vu00e9ritable avantage ru00e9side dans l'intu00e9gritu00e9 transactionnelle. Le point de terminaison valide tout avant de cru00e9er quoi que ce soit. Si un u00e9lu00e9ment u00e9choue u00e0 la validation, rien n'est cru00e9u00e9 et vous n'u00eates pas facturu00e9. Les cru00e9dits ne sont du00e9duits qu'une fois la demande de signature cru00e9u00e9e avec succu00e8s et les e-mails envoyu00e9s.

Extrait de la documentation : "Un seul appel API au lieu de deux requu00eates distinctes... Du00e9duction atomique des cru00e9dits u2013 facturation uniquement si tout ru00e9ussit."

Si vous créez des automatisations ou des flux de travail u00e0 volume u00e9levu00e9, ce point de terminaison est plus propre et plus fiable que l'enchau00eenement de deux appels.

Champs en lecture seule

Vous pouvez du00e9sormais marquer des champs comme u00e9tant en lecture seule lors de la cru00e9ation ou de la mise u00e0 jour d'une demande de signature. Il s'agit de champs qui s'affichent sur le document avec des valeurs pru00e9-remplies, mais que le signataire ne peut pas modifier.

C'est particuliu00e8rement utile pour les montants de contrats, les numu00e9ros de ru00e9fu00e9rence, les totaux calculu00e9s ou les identifiants d'employu00e9s. Tout ce que le signataire doit voir pour le contexte, mais qu'il ne doit pas pouvoir modifier.

Vous trouverez la propriu00e9tu00e9 read_only dans le point de terminaison de mise u00e0 jour complet. Du00e9finissez-la sur true sur n'importe quel champ de texte pour le rendre visible mais non modifiable.

Contru00f4les pru00e9cis des e-mails

Nous avons ajoutu00e9 quatre nouveaux paramu00e8tres qui vous permettent de contru00f4ler finement les e-mails que Firma.dev envoie en votre nom :

• send_signing_email u2013 la notification initiale "veuillez signer ce document"

• send_finish_email u2013 la confirmation "signature terminu00e9e"

• send_expiration_email u2013 le rappel lorsqu'une demande est sur le point d'expirer

• send_cancellation_email u2013 la notification lorsqu'une demande est annulu00e9e

Ces quatre paramu00e8tres sont du00e9finis par du00e9faut sur true, de sorte que les intu00e9grations existantes fonctionnent exactement de la mu00eame maniu00e8re qu'auparavant. Mais si vous pru00e9fu00e9rez envoyer vos propres e-mails personnalisu00e9s u00e0 votre image de marque plutu00f4t que les nu00f4tres, vous pouvez du00e9sormais du00e9sactiver l'un ou l'ensemble de ces e-mails et gu00e9rer les notifications vous-mu00eame.

Cela s'associe idu00e9alement avec les paramu00e8tres de marque blanche ci-dessous.

Passer les conditions de Firma.dev pour une expu00e9rience 100 % marque blanche

Il y a un nouveau paramu00e8tre dans votre espace de travail appelu00e9 "Exiger l'acceptation des conditions". Lorsqu'il est activu00e9 (par du00e9faut), les signataires doivent accepter les conditions gu00e9nu00e9rales de Firma.dev avant de pouvoir signer. Lorsque vous le du00e9sactivez, cette u00e9tape disparau00eet complu00e8tement.

Ceci est pensu00e9 pour les u00e9quipes qui souhaitent proposer un parcours de signature entiu00e8rement en marque blanche. Vos signataires voient votre image de marque, vos e-mails (si vous avez du00e9sactivu00e9 les nu00f4tres) et vos conditions gu00e9nu00e9rales. Firma.dev reste invisible.

Si vous choisissez cette option, nous vous recommandons de mettre en place vos propres conditions gu00e9nu00e9rales de vente et d'utilisation. Vous assumez la responsabilitu00e9 d'informer les signataires des implications juridiques de leur signature, assurez-vous donc que vos propres conditions gu00e9nu00e9rales couvrent ce point.

En combinant cela avec les contru00f4les d'e-mails du00e9crits ci-dessus, vous pouvez du00e9sormais proposer une expu00e9rience de signature totalement personnalisu00e9e sans qu'aucune interface Firma.dev n'apparaisse pour vos utilisateurs finaux.

Nouveaux guides de du00e9veloppement

Nous avons ru00e9u00e9crit une grande partie de notre documentation ce mois-ci. Trois nouveaux guides sont du00e9sormais en ligne :

Guide d'authentification u2013 Pru00e9sente l'authentification par clu00e9 API pour les requu00eates de serveur u00e0 serveur, ainsi que les jetons JWT pour intu00e9grer les u00e9diteurs de modu00e8les et de demandes de signature dans votre application. Comprend u00e9galement le nouveau flux de rotation des clu00e9s API avec des pu00e9riodes de gru00e2ce de 24 heures.

Guide des limites de requu00eates (Rate Limits) u2013 Documente tous les niveaux de limites de requu00eates (200 requu00eates/min pour les lectures, 120/min pour les u00e9critures, etc.). Remarque importante ici : les limites de requu00eates s'appliquent par espace de travail, et vous pouvez avoir un nombre illimitu00e9 d'espaces de travail sur votre compte. Cela vous offre une ru00e9silience et une u00e9volutivitu00e9 horizontale quasi-illimitu00e9es. Si, pour un usage spu00e9cifique, vous avez besoin de limites encore plus u00e9levu00e9es, contactez le support informatique et nous pourrons les augmenter, mais les options par du00e9faut sont du00e9ju00e0 taillu00e9es pour de tru00e8s gros volumes.

Guide de configuration complu00e8te u2013 Un parcours complet de bout en bout, de la cru00e9ation du compte jusqu'u00e0 l'intu00e9gration de la signature. Traite des espaces de travail, des modu00e8les, des demandes de signature, des u00e9diteurs intu00e9gru00e9s, des webhooks et de la gestion des cru00e9dits. Si vous du00e9butez, c'est l'endroit idu00e9al pour commencer.

Gestion complu00e8te du versioning de l'API

Nous avons introduit un systu00e8me de versioning formel ce mois-ci. L'API utilise du00e9sormais un versioning basu00e9 sur les en-tu00eates via l'en-tu00eate X-API-Version, et nous en sommes actuellement u00e0 la version v1.2.0.

Pour faire simple : nous nous engageons u00e0 ne pas casser votre intu00e9gration. Extrait du guide de gestion de versions : "Les modifications majeures qui rompent la ru00e9trocompatibilitu00e9 ne sont introduites que lors des passages de versions majeures... Les modifications mineures, comme l'ajout de nouveaux champs facultatifs ou de nouveaux points de terminaison, ne nu00e9cessitent pas de nouvelle version."

Lorsque nous finirons par publier une version v2, l'ancienne version ne disparau00eetra pas du jour au lendemain. Vous recevrez des alertes de du00e9pru00e9ciation (deprecation) dans les en-tu00eates de ru00e9ponse pendant au moins six mois avant que la version ne soit du00e9finitivement retiru00e9e. Les en-tu00eates suivent la norme RFC 8594, donc si vous suivez du00e9ju00e0 les en-tu00eates Deprecation et Sunset sur d'autres API, vous saurez u00e0 quoi vous attendre.

Pour l'instant, la v1 est active et aucune du00e9pru00e9ciation n'est planifiu00e9e. Tout ce que nous avons du00e9ployu00e9 ce mois-ci s'ajoute u00e0 l'existant, et votre intu00e9gration actuelle continue de fonctionner sans changement.

Pour conclure

Voilà pour janvier. Beaucoup de petites et moyennes amu00e9liorations qui, combinu00e9es, rendent l'API plus performante et plus flexible.

Les tarifs n'ont pas changu00e9. C'est toujours u20ac0,029 par document (enveloppe), sans engagement de duru00e9e ni volume mensuel minimal. Si vous n'avez pas encore testu00e9 Firma.dev, vous pouvez ru00e9aliser des tests gratuitement avec de vrais documents, de maniu00e8re illimitu00e9e, et ne payer que lorsque vous passez en production.

Nous allons continuer de ru00e9aliser d'autres du00e9ploiements. Si vous souhaitez voir une fonctionnalitu00e9 particuliu00e8re apparaître sur l'API, faites-le nous savoir.

Commencez gratuitement u2013 sans carte de cru00e9dit requise.