Ce que nous avons expédié en janvier 2026

Janvier a été un mois chargé. Nous avons publié une série de mises à jour sur Firma.dev qui nous enthousiasment beaucoup, et la plupart d'entre elles proviennent directement des retours que nous avons reçus des développeurs utilisant l'API.

Le thème de ce mois était de rendre l'API plus rapide, plus flexible, et plus facile à intégrer. Certains de ces changements sont de petites améliorations de qualité de vie. D'autres débloquent des flux de travail entièrement nouveaux. Nous sommes maintenant sur la version 1.2.0, et tout est actif aujourd'hui.

Voici le récapitulatif.

Demandes de Signature 40% Plus Rapides

Nous avons passé quelques semaines à creuser dans la performance et avons réussi à réduire notre latence moyenne de demande de signature de 820ms à environ 500ms. Cela représente une amélioration de 40% environ dans l'ensemble.

Les changements concernaient principalement le travail d'infrastructure. Nous avons nettoyé certaines requêtes de base de données qui étaient devenues inefficaces avec le temps, et nous avons déplacé les ressources statiques derrière AWS CloudFront pour la mise en cache en périphérie. Rien de révolutionnaire, mais le genre de travail qui s'accumule.

Si vous intégrez des signatures dans votre produit, cela compte plus qu'il n'y paraît. 300ms de latence ne semblent pas beaucoup, mais c'est la différence entre un flux de signature qui semble instantané et un qui semble lent. Des réponses plus rapides signifient moins de flux abandonnés et moins de friction pour vos utilisateurs.

Demandes de Signature Ponctuelles (Pas de Modèle Requis)

Auparavant, si vous vouliez envoyer un document pour signature via Firma.dev, vous deviez d'abord créer un modèle. Cela avait du sens pour les flux de travail répétables comme les contrats de travail ou les NDA, mais cela ajoutait des étapes inutiles pour les documents ponctuels.

Vous pouvez maintenant ignorer complètement le modèle. Téléchargez directement un PDF, définissez vos champs et vos destinataires en ligne, et envoyez-le. Un appel API, pas besoin de création de modèle.

Ceci est utile pour les accords ponctuels, les contrats uniques, ou toute situation où vous n'allez pas réutiliser la structure du document. Vous disposez toujours de tous les mêmes types de champs, options de signataire et suivi. Vous n'avez simplement pas à configurer un modèle d'abord.

Consultez le point de terminaison de création de demande de signature pour les détails d'implémentation.

Point de Terminaison Atomique Créer + Envoyer

Pour réduire le nombre d'appels API : nous avons ajouté un nouveau point de terminaison atomique qui vous permet de créer et d'envoyer une demande de signature en un seul appel.

Auparavant, vous deviez appeler le point de terminaison de création, puis appeler le point de terminaison d'envoi. Deux requêtes, deux allers retours. Le nouveau point de terminaison /signing-requests/create-and-send combine les deux en un.

Mais le véritable avantage est l'intégrité transactionnelle. Le point de terminaison valide tout avant de créer quoi que ce soit. Si quelque chose échoue lors de la validation, rien n'est créé et vous ne serez pas facturé. Les crédits ne sont déduits qu'après la création réussie de la demande de signature et l'envoi des emails.

Dans les docs : "Un seul appel API au lieu de deux requêtes séparées... Déduction de crédit atomique – ne facture que si tout réussit."

Si vous créez des automatisations ou des flux de travail à volume élevé, ce point de terminaison est plus simple et plus fiable que d'enchaîner deux appels ensemble.

Champs en Lecture Seule

Vous pouvez maintenant marquer des champs comme en lecture seule lors de la création ou de la mise à jour d'une demande de signature. Il s'agit de champs qui apparaissent sur le document avec des valeurs pré-remplies, mais que le signataire ne peut pas modifier.

Ceci est utile pour des éléments tels que les montants de contrat, les numéros de référence, les totaux calculés, ou les identifiants d'employé. Tout ce dont le signataire a besoin pour le contexte mais ne devrait pas être capable de changer.

Vous trouverez la propriété read_only dans le point de terminaison de mise à jour complète. Réglez-la sur true sur tout champ de texte, et il devient visible mais non modifiable.

Contrôles Granulaires des Emails

Nous avons ajouté quatre nouveaux paramètres qui vous donnent un contrôle fin sur les emails que Firma.dev envoie en votre nom :

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

• send_finish_email – la confirmation « signature complétée »

• send_expiration_email – le rappel lorsque qu'une demande est sur le point d'expirer

• send_cancellation_email – la notification lorsqu'une demande est annulée

Les quatre paramètres sont par défaut sur true, donc les intégrations existantes fonctionnent exactement comme avant. Mais si vous souhaitez envoyer vos propres emails de marque au lieu des nôtres, vous pouvez maintenant les désactiver individuellement et gérer vous-même les notifications.

Cela s'associe bien avec les paramètres de marque blanche ci-dessous.

Ignorer les Termes de Firma.dev pour un Marquage Complètement Personnalisé

Il y a un nouveau paramètre dans votre espace de travail appelé « Exiger l'Acceptation des Termes ». Lorsqu'il est activé (par défaut), les signataires doivent accepter les termes et conditions de Firma.dev avant de signer. Lorsque vous le désactivez, cette étape disparaît complètement.

Cela est conçu pour les équipes qui souhaitent une expérience de signature complètement personnalisée. Vos signataires voient votre marquage, vos emails (si vous avez désactivé les nôtres), et vos conditions. Firma.dev reste invisible.

Si vous choisissez cette voie, nous vous recommandons d'avoir vos propres termes et conditions en place. Vous assumez la responsabilité d'informer les signataires des implications juridiques de leur signature, alors assurez-vous que vos propres T&Cs couvrent cela.

Combiné avec les contrôles d'email ci-dessus, vous pouvez maintenant offrir une expérience de signature complètement de marque sans qu'aucune interface utilisateur de Firma.dev n'apparaisse pour vos utilisateurs finaux.

Nouveaux Guides pour Développeurs

Nous avons réécrit une partie de notre documentation ce mois-ci. Trois nouveaux guides sont en ligne :

Guide d'Authentification – Couvre l'authentification par clé API pour les demandes serveur à serveur, plus les jetons JWT pour intégrer les éditeurs de modèle et de demande de signature dans votre application. Inclut également le nouveau flux de rotation de clé API avec périodes de grâce de 24 heures.

Guide des Limites de Taux – Documente tous les niveaux de limites de taux (200 requêtes/min pour les lectures, 120/min pour les écritures, etc.). Note importante ici : les limites de taux sont par espace de travail, et vous pouvez avoir un nombre illimité d'espaces de travail sur votre compte. Cela vous offre effectivement une évolutivité horizontale illimitée. Si par hasard vous avez besoin de limites encore plus élevées pour un cas d'utilisation spécifique, contactez le support et nous pourrons les augmenter, mais les valeurs par défaut sont déjà conçues pour des volumes très élevés.

Guide de Configuration Complète – Un guide complet de bout en bout depuis la création de compte jusqu'à la signature intégrée. Couvre les espaces de travail, les modèles, les demandes de signature, les éditeurs intégrés, les webhooks, et la gestion des crédits. Si vous commencez juste, c'est ici qu'il faut commencer.

Versionnage Complet de l'API

Nous avons introduit ce mois-ci un système de versionnage formel. L'API utilise maintenant un versionnement basé sur les en-têtes via l'en-tête X-API-Version, et nous sommes actuellement sur v1.2.0.

En résumé : nous nous engageons à ne pas casser votre intégration. Dans le guide de versionnage : "Les changements rompus ne sont introduits que lors des incréments de version majeure... Les changements non rompus tels que de nouveaux champs facultatifs ou de nouveaux points de terminaison ne nécessitent pas de nouvelle version."

Quand nous publierons finalement une v2, l'ancienne version ne disparaîtra pas immédiatement. Vous recevrez des avertissements de dépréciation dans les en-têtes de réponse pendant au moins six mois avant que quoi que ce soit ne soit abandonné. Les en-têtes suivent la RFC 8594, donc si vous vérifiez déjà les en-têtes Deprecation et Sunset dans d'autres APIs, vous saurez à quoi vous attendre.

Pour l'instant, v1 est actif sans dépréciation prévue. Tout ce que nous avons expédié ce mois-ci est additif, donc votre intégration existante continue de fonctionner sans changements.

Pour Conclure

C'était janvier. Beaucoup de petites à moyennes améliorations qui se traduisent par une API plus capable, plus flexible.

Tarification inchangée. Toujours €0,029 par enveloppe, paiement à l'utilisation, sans minimum. Si vous n'avez pas encore essayé Firma.dev, vous obtenez 25 enveloppes gratuites pour tester.

Nous allons continuer d'expédier. Si vous souhaitez voir quelque chose dans l'API, faites-le nous savoir.

Commencez gratuitement – aucune carte de crédit requise.