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

Firma.dev API v1.5.0 est maintenant en ligne. Cette version de patch introduit des avertissements de validation des e-mails, un petit ajout qui vous aide à détecter les mauvaises adresses e-mail avant qu'elles ne provoquent des échecs de livraison.

Quoi de neuf

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

La demande réussit toujours. Vous recevez simplement une alerte.

Points de terminaison affectés :

Réponse exemple :

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

La validation détecte des problèmes courants tels que les extensions de domaine inhabituelles, les points manquants et les fautes de frappe évidentes. Elle ne bloquera pas les cas particuliers légitimes, mais signalera ceux qui sont les plus susceptibles de rebondir.

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 ne parviennent pas aux destinataires. Une lettre manquante, un domaine échangé, une erreur de copier-coller. Le document est envoyé, rien ne se passe, et quelqu'un ouvre un ticket de support demandant pourquoi leur client ne l'a jamais reçu.

Avec les avertissements de validation des e-mails, vous pouvez faire remonter ces problèmes à vos utilisateurs avant que la demande ne soit envoyée. Affichez l'avertissement dans votre interface utilisateur, invitez-les à vérifier à nouveau, et évitez les allers-retours.

Guide de migration

Pas de changements majeurs. Les avertissements de validation des e-mails 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 c'est applicable.

Pour profiter de cette fonctionnalité, vérifiez le tableau warnings (ou le champ warning sur PATCH) dans votre gestion de réponse et transmettez tout message à 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 à construire en quelques minutes. Prix à l'utilisation à 0,029 € par enveloppe, sans contrats ni minimums.

Commencez gratuitement

Pour la liste complète des changements, consultez la documentation de l'API.