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

La API de Firma.dev v1.5.0 ya está disponible. Esta versión de parche introduce las advertencias de validación de correo electrónico, una pequeña adición que te ayuda a detectar direcciones de correo electrónico incorrectas antes de que provoquen fallos de entrega.

Novedades

Cuando creas o actualizas una solicitud de firma, la API ahora comprueba las direcciones de correo electrónico de los destinatarios para detectar formatos potencialmente no válidos. Si algo no parece correcto, recibirás una advertencia en la respuesta.

La solicitud se procesará correctamente. Solo recibirás 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, la falta de puntos y errores tipográficos obvios. No bloqueará casos extremos legítimos, pero marcará aquellos con mayor probabilidad de rebote.

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, puedes mostrar estos problemas a tus usuarios antes de que se envíe la solicitud. Muestra la advertencia en tu interfaz de usuario, pídeles que lo comprueben y evita los malentendidos.

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 estás integrado con Firma.dev, tu código seguirá funcionando exactamente como antes. El campo warnings simplemente aparece en las respuestas cuando corresponde.

Para aprovechar esta función, comprueba el array warnings (o el campo warning en PATCH) en la gestión de respuestas y muestra los mensajes a tus usuarios.

Primeros pasos

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

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

Empieza gratis

Para ver el registro de cambios completo, consulta la documentación de la API.