Architectuur
Truncus verdeelt e-mailbezorging in twee afzonderlijke lagen.
Transportlaag
E-mailtransport wordt verzorgd door AWS SES (eu-west-1).
SES biedt wereldwijde bezorgbaarheidsinfrastructuur, gevestigde relaties met mailbox-providers en bounce- en klachtdetectie.
Truncus gebruikt SES uitsluitend als transportlaag. SES is niet zichtbaar in het API-oppervlak.
Besturingsvlak
Het Truncus-besturingsvlak draait op EU-infrastructuur.
Verantwoordelijkheden:
- Deterministische bezorgingsstatusresolutie
- Event-opslag (90 dagen bewaartermijn)
- Webhook-verzending en retry
- Idempotentie-handhaving
- Replay-systeem
- Beheer van suppressielijsten
Je API key, accountgegevens, bezorgevenementen en webhook-geschiedenis worden opgeslagen in EU-infrastructuur. SES verzorgt alleen het transport.
Bezorgingsflow
- API-verzoek ontvangen door besturingsvlak
- Validatie (API key, payload, domeinmachtiging)
- E-mail ingediend bij transportlaag (SES)
- Terminale status bepaald uit SES-feedback
- Event opgeslagen in EU-besturingsvlak
- Webhook verzonden naar je endpoint
Waarom deze scheiding bestaat
De meeste e-mail-API's stellen transportacceptatie beschikbaar als bezorgingsstatus. Acceptatie betekent dat de ontvangende server heeft ingestemd de boodschap te verwerken — niet dat deze de inbox heeft bereikt.
Door een apart besturingsvlak te handhaven boven de transportlaag kan Truncus:
- Terminale bezorgingsstatus onafhankelijk van transport bepalen en opslaan
- Alle EU-gereguleerde gegevens in EU-infrastructuur bewaren
- Replay bieden zonder opnieuw te verzenden
- Idempotentie handhaven bij retries
Dataresidentie
Transportlaag: AWS SES (globaal, eu-west-1).
Besturingsvlak: EU-infrastructuur.
Accountgegevens, event-logs, webhook-geschiedenis: EU.
Van Moose, KvK 97411698 (Nederland).