E-mail API: Complete Gids voor Ontwikkelaars (2026)

E-mail API-integratie: Van OAuth tot Real-time Synchronisatie

Een echte integratie van een e-mail-API doorloopt vier fasen, ongeacht de provider die je kiest. Lees dit gedeelte als een checklist voordat je met je implementatie begint: het overslaan van een van deze stappen is de meest voorkomende reden waarom integraties werken in de ontwikkelfase en falen in de productieomgeving.

OAuth 2.0 Authenticatie

Zowel Gmail als Microsoft Graph gebruiken de standaard OAuth 2.0 autorisatiecodeflow. De mechanismen zijn identiek: stuur de gebruiker door naar de provider, ontvang een eenmalige code op uw callback-URL, wissel deze server-side in voor een langdurige vernieuwingstoken en gebruik die vernieuwingstoken vervolgens om kortstondige toegangstokens te genereren voor elke volgende API-aanroep.

• Leid de gebruiker om naar het autorisatie-eindpunt van de provider met uw klant_id, omleiding_uri, en de gevraagde bereik.
• De gebruiker verleent toestemming, de provider stuurt door naar uw callback-URL met een eenmalige code parameter.
• Uw server wisselt dat uit code voor een toegangstoken (1 uur levensduur) en een vernieuwingstoken via een backchannel POST.
• Sla de vernieuwingstoken veilig server-side, versleuteld in rust. Dit is de langdurige inloggegevens die u gebruikt om automatisch nieuwe toegangstokens te genereren.

E-mails verzenden en ontvangen

Eenmaal geauthenticeerd, behandelen de volgende twee bewerkingen 80% van het typische gebruik van de E-mail API: de inbox ophalen en een bericht sturen. Met de unificerende API van Unipile werken beide identiek in Gmail, Outlook en IMAP via een enkele reeks eindpunten.

# Haal de laatste 50 e-mails op uit een verbonden inbox
curl --request GET \
  --url 'https://api.unipile.com/api/v1/emails?limit=50&folder=inbox' \
  --header 'X-API-KEY: YOUR_API_KEY'

# Stuur een platte tekst e-mail
curl --request POST \
  --url 'https://api.unipile.com/api/v1/emails' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "account_id": "YOUR_ACCOUNT_ID",
    "subject": "Hallo van Unipile",
    "body": "Hallo, dit is een platte tekst e-mail",
    "to": [{"display_name":"John Doe","identifier":"john@example.com"}]
  }'

Unipile ondersteunt ook de typische geavanceerde verzendfuncties die ontwikkelaars verwachten: bijlagen (multipart/form-data met meerdere bestanden), aangepaste headers (arrays doorgeven van X- vooraf gedefinieerde headers), antwoord-in-thread (met de oorspronkelijke bericht) provider_id), weergavenaam overschrijven, toegestane afzenderaliassen, en open / link tracking met realtime webhook-gebeurtenissen. Elk hiervan komt overeen met een enkel veld in de request body, zonder dat protocolonderhandeling vereist is.

# Verzenden met bijlagen + aangepaste headers + tracking
curl --request POST \
  --url 'https://api.unipile.com/api/v1/emails' \
  --header 'X-API-KEY: JOUW_API_SLEUTEL' \
  --form 'account_id=JOUW_ACCOUNT_ID' \
  --form 'subject=Contractontwerp' \
  --form 'body=Zie de v3 als bijlage.' \
  --form 'to=[{"identifier":"sarah@acme.com"}]' \
  --form 'attachments=@/pad/naar/contract.pdf' \
  --form 'attachments=@/pad/naar/appendix.png' \
  --form 'custom_headers=[{"name":"X-Campaign-ID","value":"q1-outreach"}]' \
  --form 'tracking_options={"opens":true,"links":true,"label":"q1-outreach"}'

Raadpleeg onze voor een volledige ontwikkelaarsreferentie met alle verzendopties en provider-specifiek gedrag e-mail versturen API-handleiding.

Real-Time E-mail Synchronisatie

Inboxsynchronisatie is het meest complexe deel van elke e-mailintegratie, en het deel dat het vaakst verkeerd begrepen wordt. Een robuuste e-mailsynchronisatie implementatie heeft drie duidelijke fasen: initiële synchronisatie, incrementele synchronisatie en realtime webhookmeldingen. Elk van deze aspecten overslaan leidt tot een integratie die direct werkt, maar op schaal faalt.

Plan voor verlengingen vanaf dag één: Gmail Pub/Sub watch-abonnementen verlopen na 7 dagen en moeten worden verlengd. Microsoft Graph-abonnementen op e-mailbronnen verlopen na maximaal ongeveer 3 dagen. Bouw het verlengen van abonnementen in uw achtergrondtaakinfrastructuur in voor naar productie, anders zal uw integratie stilzwijgend geen gebeurtenissen meer ontvangen.

Webhooks & Gebeurtenissen

Webhooks zijn hoe een moderne e-mail-API u in realtime vertelt dat er iets is gebeurd, zonder dat u hoeft te vragen. In plaats van te pollen /berichten elke 30 seconden (duur en traag), abonneer je je één keer, en de provider stuurt elke keer dat een nieuwe e-mail arriveert, gelezen wordt, beantwoord wordt of verwijderd wordt, een JSON-payload naar je endpoint.

De gebeurtenissen waarop u zich doorgaans abonneert, zijn ontvangen post (een nieuw bericht is aangekomen in de inbox), verstuurd (een uitgaande bericht werd succesvol afgeleverd), e_mail_geopend (de ontvanger heeft het geopend, indien tracking is ingeschakeld), mail_link_aangeklikt (de ontvanger heeft op een gevolgde link geklikt), en account_status (de verbonden mailbox moet opnieuw worden geauthenticeerd, bv. na een wachtwoordwijziging). Elke gebeurtenis bevat voldoende context voor uw downstreamsystemen om te reageren zonder aanvullende API-aanroepen te doen.