Перейти к документации
API

Отписка от отправителя

Что делает кнопка «Отписаться» на странице «Подписки».

POST/subscriptions/{id}/unsubscribe

Выполняет настоящий запрос в вашем рабочем пространстве.

POST /subscriptions/{id}/unsubscribe

Что делает кнопка «Отписаться» на странице «Подписки».

Пример

Требуется threads:write. Отписывается так, как просит отправитель: запросом в один щелчок, если он его предлагает, а иначе письмом об отписке с адреса, на который пришла почта. bin: true также перемещает все переписки от этого отправителя в корзину. Тело необязательно.

curl
curl -X POST "$OE/subscriptions/sub_5d2c8e17/unsubscribe" -H "$AUTH" \  -H "Content-Type: application/json" -d '{ "bin": true }'
Ответ
{  "object": "unsubscribe",  "subscriptionId": "sub_5d2c8e17",  "method": "one-click",  "url": null,  "binned": 58}

Отправитель, который предлагает только страницу, отвечает с method link и страницей в url, которую должен открыть человек.

Если отправитель не даёт способа отписаться, ответ будет 422 unsubscribe_unsupported, а если он не принял запрос в один щелчок и не указывает адреса, на который можно написать, ответ будет 502 unsubscribe_refused. В обоих случаях ничего не изменилось.

Справочник