Кнопка «Отписаться» внутри письма и кнопка почтового клиента — два разных пути. Первая обычно открывает GET-страницу в браузере. One-click по RFC 8058 отправляет HTTPS POST на URL из заголовка `List-Unsubscribe`. Проверьте оба пути отдельно: рабочая HTML-ссылка ничего не доказывает о служебном POST.
Для one-click нужны два заголовка, URL с непрозрачным идентификатором получателя и списка, а endpoint должен обработать тело `List-Unsubscribe=One-Click`. RFC отдельно предупреждает не возвращать redirect на такой POST: исторически перенаправления меняли метод или обрабатывались ненадёжно.
Сначала определяем, какая именно кнопка сломана
| Сценарий | Запрос | Что считать успехом |
|---|---|---|
| Ссылка в HTML | GET из браузера | Понятное подтверждение и suppression state |
| Кнопка почтового клиента | POST по RFC 8058 | 2xx без redirect и отключённая рассылка |
| mailto fallback | Письмо на служебный адрес | Автоматический разбор запроса |
| Повторный клик | Тот же token второй раз | Тот же успешный итог без дубля |
| Истёкший/поддельный token | GET или POST | Без раскрытия адреса и без изменения чужой подписки |
Откройте «Показать оригинал» у реально доставленного экземпляра. Шаблон в панели рассылки может содержать заголовки, которые провайдер удалил, переписал или не включил в DKIM-подпись.
Минимальный one-click контракт виден в исходнике
List-Unsubscribe: <https://mail.example.ru/u/opaque-signed-token>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
POST /u/opaque-signed-token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
List-Unsubscribe=One-Click
# Ожидаемый ответ: 204 No Content, без 301/302Идентификатор в примере условный. Не помещайте email открытым query-параметром: используйте непредсказуемый или подписанный token, который сервер связывает с конкретным subscription/list. RFC 8058 также требует валидную DKIM-подпись, покрывающую оба заголовка.
Endpoint меняет состояние один раз
- Проверить подпись и назначение token без пользовательской сессии и cookies.
- Найти конкретную подписку, а не глобально удалить контакт из всех обязательных потоков.
- Записать suppression state транзакционно и вернуть 2xx.
- Повтор того же POST вернуть как успех, не создавая новую операцию.
- Асинхронно передать suppression во внешние ESP и зафиксировать их acknowledgement.
Отписка от маркетинга не должна ломать обязательные сервисные сообщения, если продукт и применимое право действительно разделяют эти основания. Категории рассылки задаются явно; универсальная строка `subscribed=false` часто либо продолжает слать рекламу через другой канал, либо отключает нужные уведомления.
Редирект и защита сайта часто ломают POST
Проверьте HTTP-код без автоматического следования redirect. Типовые причины: перевод с одного hostname на другой, принудительный slash, CSRF middleware, обязательная login-cookie, WAF challenge или ожидание JSON вместо form-urlencoded. One-click endpoint — узкий публичный маршрут; защиту обеспечивает token и ограниченный контракт, а не браузерная сессия.
Не отключайте WAF целиком. Создайте точное правило только для пути и метода, оставьте rate limit и логируйте результат по token hash. Ответ не должен подтверждать, существует ли конкретный email в базе.
Кнопка появляется только у правильно собранного письма
Даже корректные заголовки не гарантируют одинаковый интерфейс во всех клиентах. Gmail в актуальных рекомендациях требует one-click для охваченных требований маркетинговых и подписных сообщений и отдельно просит видимую ссылку в теле. Проверяйте технический контракт по исходнику и запросу, а не только по наличию кнопки рядом с адресом отправителя.
Приёмка заканчивается suppression-проверкой
Отправьте письмо на тестовый адрес, выполните HTML GET и one-click POST на разных подписках, повторите запрос и затем запустите следующую кампанию. Успех: endpoint отвечает 2xx без redirect, состояние меняется один раз, контакт исключён из нужного списка, а транзакционные правила остаются неизменными.
Для разбора приложите обезличенный исходник письма, HTTP status/headers POST-ответа, token hash, subscription category и запись suppression. Полный URL с рабочим token и email получателя публиковать нельзя.