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

Firma.dev API v1.5.0 est désormais disponible. Cette version corrective introduit les avertissements de validation d'e-mail (Email Validation Warnings), 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 le format des adresses e-mail des destinataires est potentiellement invalide. Si quelque chose semble incorrect, vous recevrez un avertissement dans la réponse.

La demande est tout de même traitée avec succès. 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 elle signalera ceux qui sont les plus susceptibles d'échouer.

Pourquoi c'est important

Les fautes de frappe dans les adresses e-mail sont l'une des raisons les plus courantes pour lesquelles les demandes de signature ne parviennent pas aux destinataires. Une lettre manquante, un domaine erroné, 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 à vérifier à deux fois et évitez 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 lorsque cela est applicable.

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.

Démarrer

Si vous utilisez déjà Firma.dev, vous n'avez rien à faire. 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 au paiement à l'usage à 0,049 € par enveloppe, sans engagement ni minimum requis.

Commencer gratuitement

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