Los enlaces
| URL | Método | Quién lo abre | Respuesta |
|---|---|---|---|
/api/o/{token} | GET | El cliente de correo del destinatario, al abrir | Un GIF transparente de 1×1 |
/api/t/{token} | GET | El destinatario, al hacer clic | Un 302 hacia el destino real |
/api/unsubscribe/{token} | POST | El cliente de correo (baja en un clic RFC 8058) | Neutra, valga lo que valga el token |
/unsubscribe/{token} | página | El destinatario, desde el pie del correo | La página de baja |
/subscribe/confirm/{token} | página | Un contacto nuevo, desde el correo de opt-in | La página de confirmación |
Confirmación de doble opt-in — /subscribe/confirm/{token}
Un contacto creado mediante el flujo de doble opt-in queda en pending y recibe un correo de confirmación. Abrir el enlace lo pasa a subscribed. Hasta entonces está en la audiencia pero no recibe nada.
No hay ningún endpoint público de «suscripción». Un contacto entra en una audiencia mediante
POST /api/v1/lists/{listId}/contacts, con una clave de API; consulta la API de audiencia. La confirmación es la única mitad pública del flujo, y es una página, no una API. Nadie puede meter contactos en tus listas desde fuera.Qué significa esto para la API
El estado de un contacto es el punto de encuentro entre estos enlaces públicos y la API, y la API cede a propósito:PATCH /api/v1/contacts/{contactId}ignora unstatusenviado en el cuerpo. El estado de suscripción solo cambia mediante actos explícitos.- Un upsert nunca resucita en silencio a un contacto dado de baja.
- Un destinatario que se dio de baja desde su cliente de correo queda dado de baja para siempre; solo
POST /api/v1/contacts/{contactId}/resubscribepuede deshacerlo, y nunca para una direcciónbounced.
/api/v1. Solo existe dentro de los correos que se enviaron a ese contacto.