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 email avant qu'elles ne causent 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 un avertissement.

Points d'accès affectés :

Exemple de réponse :

{
  "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 les problèmes courants tels que les TLD inhabituels, 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 échouent à atteindre les 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 pour demander 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, incitez-les à vérifier à nouveau, et évitez les allers-retours.

Guide de migration

Aucun changement cassant. Les avertissements de validation des e-mails sont purement additifs. Si vous êtes déjà intégré avec 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 le tableau warnings (ou le champ warning sur PATCH) dans votre gestion de réponse et affichez tous les messages à vos utilisateurs.

Commencer

Si vous utilisez déjà Firma.dev, vous êtes prêt. La fonctionnalité est activée sur tous les points d'accès de demande de signature.

Nouveau sur Firma.dev ? Vous pouvez obtenir votre clé API et commencer à construire en quelques minutes. Tarification à l'utilisation à $0.029 par enveloppe, sans contrats ni minimums.

Commencer gratuitement

Pour l'ensemble des modifications, voir la documentation de l'API.