Package com.onec.mail.web

Class MailEventController

java.lang.Object

com.onec.mail.web.MailEventController

@RestController
public class MailEventController
extends Object

Inbound delivery-event webhook (enabled via onec.mail.webhook.enabled=true). Accepts a list of normalised events and feeds the MailSuppressionList: hard bounces and complaints suppress the address; unsubscribes suppress it; deliveries/opens are ignored.

Providers post their own payload shapes (SES/SNS, SendGrid, ...). Translate them to this schema — [{"email": "x@y.com", "type": "bounce|complaint|unsubscribe|delivery", "detail": "..."}] — in a thin proxy or a provider-specific controller. This endpoint intentionally stays provider-agnostic.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	MailEventController.MailWebhookEvent

Constructor Summary

Constructors

Constructor	Description
MailEventController(MailSuppressionList suppressionList)

Method Summary

Modifier and Type	Method	Description
org.springframework.http.ResponseEntity<Map<String,Integer>>	ingest(List<MailEventController.MailWebhookEvent> events)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MailEventController

public MailEventController(MailSuppressionList suppressionList)

Method Details

ingest

@PostMapping(path="${onec.mail.webhook.path:/onec/mail/events}")
public org.springframework.http.ResponseEntity<Map<String,Integer>> ingest(@RequestBody
 List<MailEventController.MailWebhookEvent> events)