Baja de una categoría de avisos en un clic (pública, RFC 8058)
Apaga la categoría del token en alertas_preferencias (upsert: la fila solo existe si el usuario tocó sus ajustes).
Es el destino del un clic de Gmail: Brevo añade List-Unsubscribe-Post: List-Unsubscribe=One-Click a todo lo que sale por su API, y por RFC 8058 eso obliga a que un POST a la URL de List-Unsubscribe dé de baja sin más interacción. Antes la cabecera apuntaba al panel, que respondía 405: se anunciaba la baja en un clic y no se honraba, que es justo lo que Gmail y Yahoo penalizan desde 2024.
Responde 200 también con un token inválido: el cliente de correo enseña el resultado al usuario y un 4xx solo diría «algo falló» sin que pueda hacer nada. Lo que no ocurre nunca es dar de baja a quien no toca, y de eso se encarga la firma.
transaccional no se puede dar de baja por aquí: no es una categoría firmable.
Request
- Base URL: https://contadeo.com/api
- URL: https://contadeo.com/api/correo/baja
- Auth: none required
Query parameters
Token firmado que identifica al usuario y la categoría. Lo genera CorreoService.urlBajaUnClic() y viaja en la cabecera List-Unsubscribe del propio correo.
Response
Baja aplicada, o aviso de que el enlace no es válido. Siempre 200, nunca el 201 por defecto de Nest: esto no crea nada y el cliente de correo que hace el un-clic espera un OK a secas.
Changes
No recorded changes to this operation across all 2 revisions of this API.