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

L'API Firma.dev v1.5.0 est désormais disponible. Cette version corrective introduit les avertissements de validation d'e-mail, un petit ajout qui vous aide à détecter les adresses e-mail incorrectes avant qu'elles ne provoquent des échecs de distribution.

Qu'est-ce qui est nouveau ?

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

La demande réussit tout de même. Vous recevez simplement une notification.

Points de terminaison concernés :

Exemple de réponse :

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

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

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

La validation détecte les problèmes courants tels que les extensions de domaine (TLD) inhabituelles, les points manquants et les fautes de frappe évidentes. Elle ne bloquera pas les cas particuliers légitimes, mais signalera ceux qui sont le plus susceptibles de générer un rejet de distribution.

Pourquoi c'est important

Les fautes de frappe dans les adresses e-mail sont l'une des raisons les plus fréquentes pour lesquelles les demandes de signature ne parviennent pas aux destinataires. Une lettre manquante, un domaine interverti, une erreur de copier-coller... Le document est envoyé, rien ne se passe, et quelqu'un ouvre un ticket d'assistance pour demander pourquoi son client ne l'a jamais reçu.

Grâce aux avertissements de validation d'e-mail, vous pouvez signaler ces problèmes à vos utilisateurs avant l'envoi de la demande. Affichez l'avertissement dans votre interface utilisateur, invitez-les à double-vérifier, et évitez ainsi les allers-retours.

Guide de migration

Aucun changement de rupture. Les avertissements de validation d'e-mail sont purement additifs. Si vous êtes déjà intégré à Firma.dev, votre code continuera de fonctionner exactement comme avant. Le champ warnings apparaît simplement dans les réponses le cas échéant.

Pour profiter de cette fonctionnalité, vérifiez la présence du tableau warnings (ou du champ warning pour PATCH) lors du traitement de vos réponses et affichez les messages correspondants à vos utilisateurs.

Commencer

Si vous utilisez déjà Firma.dev, vous êtes prêt. La fonctionnalité est active sur tous les points de terminaison de demande de signature.

Nouveau sur Firma.dev ? Vous pouvez obtenir votre clé API et commencer à coder en quelques minutes. Tarification à l'usage à 0,049 € par enveloppe, sans contrat ni minimum.

Commencer gratuitement

Pour consulter l'historique complet des modifications, reportez-vous à la documentation de l'API.