POST /api/unsubscribe/{token}
El destino del encabezado List-Unsubscribe-Post (RFC 8058), llamado por Gmail y compañía cuando el destinatario usa el botón de baja propio de su cliente de correo. Con límite de peticiones por IP.
La respuesta es siempre neutra: un token desconocido recibe la misma respuesta que uno válido. Confirmar que un token existe confirmaría que una dirección está en una lista.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
OWNER | Permitido |
ADMIN | Permitido |
MEMBER | Permitido |
Parámetros de ruta
| Parámetro | Tipo | Descripción |
|---|---|---|
token | string | Obligatorio. Opaco, por destinatario y por envío. Se genera por ti y viaja dentro del correo |
Ejemplo
bash
curl -i -X POST "https://www.agentsmail.io/api/unsubscribe/$TOKEN"Respuesta
201 Created: el recurso creado.401 Unauthorized: clave ausente o no válida, o su propietario dejó la organización.404 Not Found: no existe ese recurso, o pertenece a otra organización. La API nunca confirma que un id existe a quien no tiene derecho sobre él.429 Too Many Requests: más de 120 peticiones en un minuto para esta clave.