이메일 캠페인을 진행하거나 앱과 ESP 간에 연락처를 동기화할 때, 명확한 규칙이 필요합니다: 메일을 받을 수 있는 사람과 제외해야 할 사람. verify-email.app은 ESP의 구독 해지 링크나 법적 준수를 대체하지 않지만, 모든 확인 응답에 단일 필드로 나타나는 블랙리스트 및 화이트리스트 규칙을 제공합니다: block. 코드는 발송 전에 block을 읽을 수 있으며, 목록을 가져오거나 계정을 생성할 때 허용/거부 로직을 서비스마다 복사하지 않아도 됩니다.

• 블랙리스트 — 이메일이나 도메인이 블랙리스트에 있는 경우 API는 block: true를 반환합니다. 이는 구독 해지한 사람들, 악용 사례 또는 메일을 보내고 싶지 않은 도메인에 사용하세요.

• 화이트리스트 — 화이트리스트 모드가 켜져 있는 경우 추가한 주소(또는 전체 도메인)만 block: false를 얻습니다. 다른 모든 사람은 block: true를 받습니다. 이는 초대장, 파트너, 내부 베타에 사용하고 일반적인 "누구나 구독할 수 있는" 뉴스레터에는 사용하지 마세요.

• 순서 — 블랙리스트가 우선합니다. 주소가 블랙리스트에 있는 경우 화이트리스트에 나타나더라도 차단된 상태로 유지됩니다.

1. 사용자가 앱에서 구독 해지했거나 ESP 웹훅을 처리할 때 주소(또는 정책에 따라 차단할 도메인)을 가져옵니다.

2. POST /v1/blacklist와 JSON 본문 {"value": "[email protected]"} (또는 해당 도메인의 모든 주소를 차단하기 위한 "example.com")을 사용하여 추가합니다. 헤더 X-API-Key에 API 키를 사용하세요.

3. 캠페인을 보낼 때나 메일링 도구에 행을 푸시하기 전에 주소를 확인하세요. block 이 true일 경우, 해당 수신자를 건너뜁니다.

나중에 다시 허용하려면 (예: 재구독 및 확인한 경우), DELETE /v1/[email protected]로 규칙을 제거하세요.

1. 엄격한 허용 전용 모드 켜기: PUT /v1/whitelist/enabled와 본문 {"enabled": true}를 사용하세요.

2. 승인된 각 주소나 도메인 추가: POST /v1/whitelist와 {"value": "[email protected]"} 또는 {"value": "company.com"}.

3. 확인 시, block: false이면 화이트리스트에 따라 주소가 허용되며, 다른 사람들은 추가될 때까지 차단됩니다.

허용 전용 모드가 필요하지 않을 때 (예: 공공 가입이 복귀할 때), enabled를 다시 false로 설계하여 화이트리스트가 다른 모든 사람을 제한하지 않도록 합니다.

대부분의 제품은 ESP에 동의 상태를 저장하고 억제 리스트를 유지합니다. verify-email.app에서는 보통 구독 해지된 경우 블랙리스트에서 주소를 제거한 후(DELETE 블랙리스트에서), 실제 구독 상태에 대해서는 ESP에 의존합니다. 화이트리스트는 승인된 이메일만 통과할 수 있는 흐름에 예약하세요.

대시보드에서도 API와 동일한 규칙을 관리할 수 있습니다—자세한 내용과 API 세부 정보는 verify-email.app의 블랙리스트와 화이트리스트 페이지를 참조하십시오.