Saltar al contenido principal
MailLand

Correo de autenticación

Restablecimientos de contraseña, códigos de un solo uso y enlaces mágicos, una llamada a la API cada uno

El correo de inicio de sesión es el que los usuarios esperan delante de la pantalla. MailLand le ofrece plantillas que nunca salen con un marcador sin sustituir, claves de idempotencia que convierten una solicitud reintentada en una repetición de la respuesta en lugar de enviar otro correo, y eventos de entrega que puede mostrar en su propia interfaz.

Por qué el correo de autenticación requiere más cuidado

  • Alguien está esperando

    Un usuario está en su pantalla de inicio de sesión. Un código que nunca llega, o que llega dos veces, se convierte en una incidencia de soporte o en un registro perdido.

  • Los receptores comprueban quién lo envió

    Los proveedores de buzones comprueban SPF, DKIM y DMARC. MailLand le muestra los registros que debe publicar y firma cada mensaje con la clave DKIM de su dominio.

  • Un error tipográfico rompe el flujo

    Una dirección mal escrita en el registro significa que cada código posterior no llega a ninguna parte. Detéctelo cuando se introduce la dirección, no después del primer inicio de sesión fallido.

Un código de un solo uso, enviado desde una plantilla almacenada

El código se pasa como variable por destinatario. La clave de idempotencia hace que reintentar tras un tiempo de espera agotado sea seguro.

curl -X POST https://api.mail.land/v1/transactional/send \
  -H "X-API-Key: ml_pet_..." \
  -H "X-Idempotency-Key: signin-7f3a9c-1" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "[email protected]", "name": "Your App" },
    "to": [{
      "email": "[email protected]",
      "variables": { "code": "482913" }
    }],
    "templateId": "t8x2m4q9zk7wpr",
    "variables": { "expiresInMinutes": "10" },
    "tags": ["sign-in-code"]
  }'
Si {{code}} no tuviera valor, MailLand rechazaría la solicitud con 422 TEMPLATE_VARIABLE_MISSING en lugar de enviar un correo defectuoso.

Lo que MailLand le ofrece para el correo de inicio de sesión

  • Plantillas que se niegan a enviar un mensaje defectuoso

    Guarde las plantillas de restablecimiento, de código y de enlace mágico en MailLand y rellene los {{placeholders}} en cada solicitud. Un valor ausente detiene el envío con un 422 que nombra la variable.

  • Reintentos sin duplicados

    Envíe una X-Idempotency-Key con cada código. Si su solicitud agota el tiempo de espera y la reintenta con la misma clave dentro de las 24 horas, MailLand devuelve la respuesta original y no envía nada.

  • Protección ante errores tipográficos y dominios desechables

    Active la protección para su flujo transaccional y MailLand rechazará las direcciones de proveedores desechables o con un probable error tipográfico en el dominio, y sugerirá la dirección corregida.

  • Validación en el registro

    Llame a la API de validación cuando un usuario se registre. Comprueba la sintaxis, los probables errores tipográficos, los dominios desechables, las cuentas de rol como info@ y el servidor de correo receptor.

  • Eventos de entrega para su interfaz

    Los eventos de entrega, aplazamiento, rebote y fallo llegan a su webhook, para que su aplicación pueda pedir al usuario que revise la dirección o lo intente de nuevo.

  • Enlaces tal como los escribió

    El seguimiento de aperturas y clics está desactivado por defecto para el correo transaccional, así que, a menos que active el seguimiento, los enlaces de restablecimiento y los enlaces mágicos llegan a los usuarios exactamente como usted los escribió.

Enviado desde su propio dominio

Añada su dominio, publique los registros SPF, DKIM y DMARC que muestra el panel, y MailLand los verificará antes de que pueda enviar. Cada dominio recibe automáticamente su propia clave DKIM RSA de 2048 bits.

Lo que no prometemos

No publicamos ninguna cifra de tiempo de entrega: el servidor de correo receptor decide cuándo acepta un mensaje. Lo que MailLand le ofrece es un registro completo de lo que ocurrió con cada mensaje y cuándo.

Preguntas sobre el correo de autenticación

¿Cuánto tardará en llegar un código?

No publicamos ninguna promesa de tiempo de entrega. La API responde en cuanto el mensaje está en cola, y la respuesta indica cuándo. Después, el evento de entrega o de aplazamiento le indica cuándo el servidor receptor aceptó el mensaje o pidió reintentarlo.

¿Cómo debo gestionar que el usuario pulse reenviar?

Trate cada código nuevo como una solicitud nueva con una clave de idempotencia nueva. Reutilice una clave solo cuando reintente la misma solicitud tras un tiempo de espera agotado: dentro de las 24 horas, ese reintento devuelve la respuesta original y no envía nada.

¿Puedo bloquear direcciones desechables en el registro?

Sí, de dos maneras. Active la protección contra dominios desechables para el flujo transaccional, o llame a la API de validación antes de crear la cuenta.

¿Puedo probar el flujo sin enviar correos a usuarios reales?

Sí. Una clave de sandbox acepta y registra cada solicitud sin entregarla, o solo entrega a una lista de direcciones permitidas que usted elige.

¿Puede una baja de marketing detener los restablecimientos de contraseña?

No. Una baja se aplica al correo de marketing o a una lista, y no suprime el correo transaccional a esa dirección.

Envíe hoy su primer código de inicio de sesión

Cree una cuenta gratuita, verifique su dominio y guarde su primera plantilla. 1.000 correos al mes son gratuitos.