Firma.dev API v1.5.0: Advertencias de Validación de Correo Electrónico

La API v1.5.0 de Firma.dev ya está disponible. Esta versión de corrección de errores introduce las advertencias de validación de correo electrónico (Email Validation Warnings), una pequeña adición que ayuda a detectar direcciones de correo incorrectas antes de que causen fallos de entrega.

Novedades

Al crear o actualizar una solicitud de firma, la API ahora comprueba si las direcciones de correo electrónico de los destinatarios tienen formatos potencialmente no válidos. Si algo parece incorrecto, recibirá una advertencia en la respuesta.

La solicitud se sigue realizando correctamente. Solo recibirá un aviso.

Endpoints afectados:

Ejemplo de respuesta:

{
  "signing_request": { ... },
  "warnings": [
    "El correo electrónico del destinatario 'user@compny' puede tener un formato no válido"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "El correo electrónico del destinatario 'user@compny' puede tener un formato no válido"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "El correo electrónico del destinatario 'user@compny' puede tener un formato no válido"
  ]
}

La validación detecta problemas comunes como dominios de nivel superior (TLD) poco habituales, puntos ausentes y errores tipográficos obvios. No bloqueará casos extremos legítimos, pero marcará aquellos que tengan más probabilidades de rebotar.

Por qué es importante

Los errores tipográficos en el correo electrónico son uno de los motivos más comunes por los que las solicitudes de firma no llegan a los destinatarios. Una letra omitida, un dominio cambiado, un error al copiar y pegar. El documento se envía, no ocurre nada y alguien abre un ticket de soporte preguntando por qué su cliente nunca lo recibió.

Con las advertencias de validación de correo electrónico, puede mostrar estos problemas a sus usuarios antes de enviar la solicitud. Muestre la advertencia en su interfaz de usuario, pídales que lo comprueben dos veces y evite los idas y venidas.

Guía de migración

Sin cambios que rompan la compatibilidad. Las advertencias de validación de correo electrónico son puramente aditivas. Si ya se ha integrado con Firma.dev, su código seguirá funcionando exactamente igual que antes. El campo warnings simplemente aparece en las respuestas cuando corresponde.

Para aprovechar esta función, compruebe si existe el array warnings (o el campo warning en PATCH) en la gestión de respuestas y muestre los mensajes a sus usuarios.

Primeros pasos

Si ya utiliza Firma.dev, ya está todo listo. La función está activa en todos los endpoints de solicitud de firma.

¿Es nuevo en Firma.dev? Puede obtener su clave de API y empezar a compilar en cuestión de minutos. Tarifas de pago por uso a 0,049 € por sobre, sin contratos ni mínimos.

Comience gratis

Para ver el historial de cambios completo, consulte la documentación de la API.