Laatst bijgewerkt: 2026-03-033 min leestijd

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

  1. API-verzoek ontvangen door besturingsvlak
  2. Validatie (API key, payload, domeinmachtiging)
  3. E-mail ingediend bij transportlaag (SES)
  4. Terminale status bepaald uit SES-feedback
  5. Event opgeslagen in EU-besturingsvlak
  6. 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).

Architectuur