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

Firma.dev API v1.5.0 ya está disponible. Esta versión de parche introduce advertencias de validación de correo electrónico, una pequeña mejora que te ayuda a detectar direcciones de correo electrónico incorrectas antes de que causen 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 en busca de formatos potencialmente no válidos. Si algo parece raro, recibirás una advertencia en la respuesta.

La solicitud sigue completándose correctamente. Solo recibes 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 TLD poco habituales, puntos que faltan y errores tipográficos evidentes. No bloqueará casos límite legítimos, pero señalará los que tienen más probabilidades de rebotar.

Por qué es importante

Los errores tipográficos en los correos electrónicos son una de las razones más comunes por las que las solicitudes de firma no llegan a los destinatarios. Una letra que falta, un dominio intercambiado, un error de 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, pídeles que lo revisen dos veces y evita el ida y vuelta.

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 igual que antes. El warnings field simplemente aparece en las respuestas cuando corresponde.

Para aprovechar la función, comprueba el array warnings (o el campo warning en PATCH) en el manejo de respuestas y muestra cualquier mensaje a tus usuarios.

Empieza

Si ya estás usando Firma.dev, ya lo tienes todo listo. La función ya está disponible en todos los endpoints de solicitudes de firma.

¿Eres nuevo en Firma.dev? Puedes obtener tu clave de API y empezar a desarrollar en minutos. precio de pago por uso de 0,029 € por sobre, sin contratos ni mínimos.

Empieza gratis

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