Firma.dev API v1.5.0 : Avertissements de validation des e-mails

Firma.dev API v1.5.0 est désormais en ligne. Cette version corrective introduit les avertissements de validation des e-mails, une petite amélioration qui vous aide à détecter les adresses e-mail incorrectes avant qu’elles ne provoquent des échecs de livraison.

Nouveautés

Lorsque vous créez ou mettez à jour une demande de signature, l’API vérifie désormais les adresses e-mail des destinataires afin de détecter des formats potentiellement invalides. Si quelque chose semble anormal, vous recevrez un avertissement dans la réponse.

La requête réussit quand même. Vous recevez simplement un avertissement.

Points de terminaison concernés :

Exemple de réponse :

{
  "signing_request": { ... },
  "warnings": [
    "L’adresse e-mail du destinataire 'user@compny' peut avoir un format invalide"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "L’adresse e-mail du destinataire 'user@compny' peut avoir un format invalide"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "L’adresse e-mail du destinataire 'user@compny' peut avoir un format invalide"
  ]
}

La validation détecte des problèmes courants comme des TLD inhabituels, des points manquants et des fautes de frappe évidentes. Elle ne bloquera pas les cas limites légitimes, mais elle signalera ceux qui risquent le plus d’être rejetés.

Pourquoi c’est important

Les fautes de frappe dans les e-mails sont l’une des raisons les plus courantes pour lesquelles les demandes de signature n’atteignent pas les destinataires. Une lettre manquante, un domaine remplacé, une erreur de copier-coller. Le document est envoyé, il ne se passe rien, et quelqu’un ouvre un ticket d’assistance pour demander pourquoi son client ne l’a jamais reçu.

Avec les avertissements de validation des e-mails, vous pouvez signaler ces problèmes à vos utilisateurs avant l’envoi de la demande. Affichez l’avertissement dans votre interface, invitez-les à vérifier une seconde fois et évitez les allers-retours.

Guide de migration

Aucune rupture de compatibilité. Les avertissements de validation des e-mails sont purement additifs. Si vous êtes déjà intégré à Firma.dev, votre code continuera à fonctionner exactement comme avant. Le champ warnings apparaît simplement dans les réponses lorsque cela s’applique.

Pour profiter de la fonctionnalité, vérifiez la présence du tableau warnings (ou du champ warning sur PATCH) dans le traitement de vos réponses et affichez les messages éventuels à vos utilisateurs.

Premiers pas

Si vous utilisez déjà Firma.dev, tout est prêt. La fonctionnalité est disponible sur tous les points de terminaison des demandes de signature.

Vous découvrez Firma.dev ? Vous pouvez obtenir votre clé API et commencer à développer en quelques minutes. Tarification à l’usage à 0,029 € par enveloppe, sans contrat ni minimums.

Commencez gratuitement

Pour consulter le journal des modifications complet, voir la documentation de l’API.