문서로 건너뛰기
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입니다. 어느 경우든 바뀐 것은 없습니다.

레퍼런스