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

Firma.dev API v1.5.0 ahora está en vivo. 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 para detectar formatos potencialmente inválidos. Si algo parece estar mal, recibirás una advertencia en la respuesta.

La solicitud aún se procesa con éxito. Solo obtienes 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 obvios. No bloqueará casos límite legítimos, pero señalará aquellos que probablemente reboten.

Por qué es importante

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 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 destacar estos problemas a tus usuarios antes de que la solicitud salga. Muestra la advertencia en tu UI, invítalos a verificar de nuevo y evita el ir y venir.

Guía de Migración

Sin cambios disruptivos. 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 campo warnings simplemente aparece en las respuestas cuando sea aplicable.

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

Comienza Ahora

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

¿Nuevo en Firma.dev? Puedes obtener tu clave de API y comenzar a construir en minutos. Pago según el uso a un precio de $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.