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 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 causen fallos en la entrega.

Novedades

Cuando creas o actualizas una solicitud de firma, la API ahora verifica las direcciones de correo electrónico de los destinatarios en busca de posibles formatos no válidos. Si algo parece incorrecto, recibirás una advertencia en la respuesta.

La solicitud todavía tiene éxito. Simplemente recibes un aviso.

Endpoints afectados:

Respuesta de ejemplo:

{
  "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 validación detecta problemas comunes como TLDs inusuales, puntos faltantes y errores tipográficos evidentes. No bloqueará casos excepcionales legítimos, pero señalará aquellos que probablemente generen un rebote.

Por Qué Esto Importa

Los errores tipográficos en 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 faltante, un dominio intercambiado, un error de copiar y pegar. El documento se envía, no sucede nada, y alguien abre un ticket de soporte preguntando por qué el cliente nunca lo recibió.

Con las advertencias de validación de correo electrónico, puedes presentar estos problemas a tus usuarios antes de que la solicitud se envíe. Muestra la advertencia en tu interfaz de usuario, incítalos a verificar nuevamente y evita el ir y venir.

Guía de Migración

No hay cambios importantes. 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 aparecerá en las respuestas cuando sea aplicable.

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

Comienza Ahora

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

¿Nuevo en Firma.dev? Puedes obtener tu clave API y comenzar a construir en minutos. Precios de pago conforme al uso a €0,029 por sobre, sin contratos ni mínimos.

Comienza gratis

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