LinkedIn
Instagram
WhatsApp
Telegram
Google Agenda
Word lid van de Slack-gemeenschapBouwen aan multi-provider e-mail-API integratie die werkt met Gmail, Outlook en IMAP is een van de meest tijdrovende uitdagingen voor ontwikkelteams. Elke provider levert zijn eigen OAuth-stroom, snelheidslimieten en gegevensmodel. unificerende e-mail-API abstract dat allemaal in één REST-interface - dus je schrijft één integratie en krijgt dekking voor elke belangrijke inbox waar je gebruikers op vertrouwen.
Wat je zult leren
Volledige E-mail API Gids
Leer hoe Gmail, Outlook en IMAP samenwerken onder één uniforme REST API.
Waarom ontwikkelaars een multi-provider e-mail API nodig hebben
De meeste SaaS-producten moeten uiteindelijk e-mails namens hun gebruikers lezen of verzenden. Het probleem zit niet in het concept, maar in de uitvoering. Gmail gebruikt de Gmail API met Google OAuth 2.0. Outlook gebruikt Microsoft Graph met zijn eigen tokenlevenscyclus. IMAP-gebaseerde providers gedragen zich elk iets anders. Het bouwen en onderhouden van drie afzonderlijke integraties put machinecycli uit die gericht zouden moeten zijn op uw kernproduct. Als u specifiek te maken heeft met IMAP-accounts, zal de IMAP API-gids omvat de extra complexiteit die ermee gemoeid is. A unificerende e-mail-API lost dit op door alle provider-specifieke complexiteit achter één interface te verbergen - dat is de kernbelofte van een multi-provider e-mail-API aanpak. Voor een uitgebreide technische referentie hoe e-mail Verzenden API oproepen via Gmail, Outlook en IMAP, bekijk onze speciale gids.
De 3 e-mailproviders bedekt
Eén uniforme API normaliseert Gmail, Outlook en IMAP naar een identieke interface. Je code verandert nooit wanneer een gebruiker een andere provider verbindt.
Koppel elk Gmail- of Google Workspace-account via Google OAuth 2.0. Verstuur, lees, zoek en synchroniseer threads in realtime via de Unipile-laag - geen directe Gmail API-referenties vereist in uw app.
Ondersteunt persoonlijke Outlook-accounts, Microsoft 365 en Exchange Online onder één provider. Microsoft OAuth wordt beheerd door Unipile – uw integratie blijft stabiel bij verschillende tenantconfiguraties.
Elke mailbox die toegankelijk is via IMAP - Yahoo, Fastmail, ProtonMail Bridge, aangepaste bedrijfsservers - wordt direct toegankelijk via hetzelfde API-oppervlak als dat voor Gmail en Outlook wordt gebruikt.
Unipile vs zelf bouwen
Wat kost het eigenlijk om zelf een [voorwerp/klas] te maken multi-provider e-mail-API integratie? Hier is een eerlijke vergelijking over de dimensies die ertoe doen in productie. Daarom kiezen teams steeds vaker voor een unificerende e-mail-API zoals Unipile in plaats van elke providerintegratie vanaf nul op te bouwen.
Hoe de integratie werkt
Het verbinden van uw eerste e-mailaccount met Unipile kost vier stappen. Dezelfde procedure werkt ongeacht of de gebruiker een Gmail-, Outlook- of IMAP-account - uw applicatiecode blijft volledig identiek. Dit is de praktische kracht van een uniforme e-mail-API: schrijf één keer, dek alle drie de providers.
Je backend roept de Unipile API aan om een kortstondige gehoste authenticatie-URL te maken. Omleid de gebruiker naar die URL - Unipile presenteert het scherm voor providerselectie en handelt de volledige OAuth-flow namens jou af.
// POST /api/v1/hosted/accounts/link const resultaat = wacht op fetch('https://api5.unipile.com:13515/api/v1/hosted/accounts/link', methode: POST, headers: { 'X-API-KEY': process.env.UNIPILE_API_SLEUTEL, 'Content-Type': "toepassing/json }, body: JSON.stringify({ type: 'E-mail', providers_filter: ['GOOGLE', 'MICROSOFT', 'IMAP'], succes_doorverwijs_url: 'https://jouwapp.com/auth/success' }) }); const { url } = wacht op res.json(); // gebruiker doorsturen naar `url`
Nadat de gebruiker OAuth heeft voltooid, stuurt Unipile een webhook naar uw eindpunt (of voegt de account-ID toe aan uw omleidings-URL). Sla deze account-ID op - het is uw permanente referentie naar dat gekoppelde account, onafhankelijk van de provider.
{
"gebeurtenis": "account.verbonden",
"account_id": "acc_01HXYZ...",
"provider": "GOOGLE",
"e-mail": "alice@gmail.com"
}
Gebruik de account-ID om e-mails te sorteren, te zoeken en op te halen. Dit is de unificerende e-mail-API in actie: het response schema is identiek, ongeacht of het account Gmail, Outlook of IMAP is - uw parsinglogica vertakt nooit op provider.
// OPHALEN /api/v1/emails?account_id=acc_01HXYZ... const emails = wacht op fetch( https://api5.unipile.com:13515/api/v1/emails?account_id=${accountId}&limiet=20, { headers: { 'X-API-KEY': process.env.UNIPILE_API_SLEUTEL } } ).dan(r => r.json()); // Zelfde responsstructuur voor Gmail, Outlook, IMAP: // { id, onderwerp, van, naar, datum, inhoud, bijlagen }
Een enkel POST-eindpunt verzendt e-mail, ongeacht de provider achter het account – dit is de volledige kracht van een multi-provider e-mail-API. Geef de account-ID, ontvanger, onderwerp en hoofdtekst door - Unipile routeert via de Gmail API, Microsoft Graph of SMTP zoals gepast. Dit is de unificerende e-mail-API In zijn meest concrete vorm: één eindpunt, drie providers, nul vertakking in je code.
// POST /api/v1/emails/verzenden wacht op fetch('https://api5.unipile.com:13515/api/v1/emails/send', methode: POST, headers: { 'X-API-KEY': process.env.UNIPILE_API_SLEUTEL, 'Content-Type': "toepassing/json }, body: JSON.stringify({ account_id: 'acc_01HXYZ...', naar: [{ e-mail: 'bob@example.com' }], onderwerp: 'Hallo van Unipile', lichaam: 'Werkt met Gmail, Outlook en IMAP.
' }) });
Hoe provider abstractie werkt
De uniforme e-mail-API bevindt zich tussen uw toepassing en de drie onderliggende providerprotocollen - en vertaalt uiteenlopende OAuth-stromen, gegevensschema's en rate-limitmodellen naar één consistente interface.
Gmail gebruikt Google OAuth 2.0 met een specifieke token-verversingscyclus en retourneert e-mails in een thread-centrisch model met labels. Outlook gebruikt Microsoft Graph met een ander OAuth tenant-model en retourneert e-mails als individuele berichtobjecten met mappen. IMAP-servers hebben elk hun eigen verbindingsparameters, authenticatiemethoden en capaciteitensets.
Unipile unificerende e-mail-API normaliseert alle drie tot één REST-interface. Uw code roept /api/v1/emails en ontvangt identiek gevormde antwoordobjecten - ongeacht of het onderliggende account een Gmail-, Outlook- of IMAP-account is. Hetzelfde geldt voor het verzenden, het verwerken van bijlagen, webhook-gebeurtenissen en het beheer van de accountlevenscyclus.
Dit is het belangrijkste technische voordeel van de multi-provider e-mail-API de complexiteit wordt geabsorbeerd in de infrastructuurlaag, niet in je applicatiecode. Wanneer Google zijn OAuth-scope-vereisten wijzigt of Microsoft de paginatie van Graph API bijwerkt, verwerkt Unipile de upstreamwijziging - je integratie blijft intact.
Beveiliging en naleving
Wanneer uw applicatie namens gebruikers e-mail afhandelt, is beveiliging geen optie. Hier is hoe de uniforme e-mail API-laag omgaat met inloggegevens, gegevens en complianceverplichtingen.
Unipile slaat OAuth-tokens namens u op en vernieuwt ze. Uw toepassing verwerkt nooit ruwe gegevens - u werkt alleen met ondoorzichtige account-ID's. Tokenrotatie, vervaldetectie en herauthenticatiestromen worden volledig beheerd op infrastructuurniveau.
Alle gegevens tijdens het transport maken gebruik van TLS 1.3. Opgeslagen inloggegevens worden versleuteld tijdens opslag met AES-256. E-mailinhoud die wordt opgehaald via de unified email API wordt verwerkt in het geheugen en wordt niet langer bewaard dan wat uw integratie expliciet aanvraagt.
Unipile is SOC 2 Type II gecertificeerd (oktober 2025). Onafhankelijke auditors hebben de beveiliging, beschikbaarheid en vertrouwelijkheid van het platform geverifieerd. Auditrapporten zijn op aanvraag beschikbaar voor enterprise klanten die de multi-provider e-mail API evalueren voor productiegebruik.
Gegevensverwerkingsovereenkomsten zijn beschikbaar voor alle abonnementen. Er wordt een EU-datacenteroptie aangeboden voor klanten met vereisten voor gegevenslokalisatie. Het recht op verwijdering wordt ondersteund via API: het verwijderen van een gekoppeld account verwijdert alle bijbehorende tokens en gecachte gegevens.
Google Cloud Application Security Assessment. Valideert beveiligingscontroles voor applicaties die toegang hebben tot Google-gebruikersgegevens, inclusief Gmail OAuth-bereiken. Apps gebouwd op Unipile nemen deze certificering over.
Uptime en incidenthistorie zijn publiekelijk beschikbaar op status.unipile.com. Alle API-wijzigingen volgen een versiebeleid met aankondigingen van het buiten gebruik stellen. Geen stille wijzigingen die de functionaliteit verbreken: uw integratie wordt beschermd door een stabiel, gedocumenteerd contract.
Omgaan met randgevallen over providers
Elke productie-e-mailintegratie loopt tegen provider-specifieke uitzonderingen aan. Hier is hoe een doe-het-zelfaanpak zich verhoudt tot het gebruik van een uniforme e-mail-API wanneer de zaken ingewikkeld worden.
| Scenario | Doe-het-zelfaanpak | Unipile benadering |
|---|---|---|
| Gmail snelheidslimiet 250 quotakoppelingen/dag gratis niveau |
Handmatige quota-tracking per account; verzoeken mislukken stilzwijgend indien niet gemonitord | Automatisch afgehandeld Ingebouwde wachtrij, geen mislukte verzoeken gemeld aan uw app |
| OAuth-tokengebruiksduur | Implementeer aparte vernieuwingslogica per provider; tokenrotatie verschilt tussen Google en Microsoft | Automatisch verversen Tokenbeheer met n gedoseerde uitvaltijd bij alle providers |
| IMAP-verbinding verbreekt | Aangepaste herverbindingslogica per serverconfiguratie; time-outs variëren per IMAP-implementatie | Connectionpool beheerd Persisterende verbindingen onderhouden door Unipile-infrastructuur |
| Bestandsgrootte limieten Gmail 25MB, Outlook 150MB, IMAP varieert |
Per-provider aftakkingscode; moet het limiet van elke provider bijhouden en updaten wanneer deze verandert | Verenigde validatie Provider-agnostische groottevalidatie; fouten geretourneerd in een consistent schema |
| Provider API-wijzigingen | Je on-call verantwoordelijkheid; Google en Microsoft pushen breaking changes met beperkte kennisgeving | Afgehandeld door het Unipile-team Stroomopwaartse wijzigingen worden op infrastructuurniveau verwerkt; uw integratie blijft stabiel |
Gmail snelheidslimiet
250 quotakoppelingen/dag gratis niveauHandmatige quota-tracking per account; verzoeken mislukken stilzwijgend indien niet gemonitord
De pijlergids behandelt elk eindpunt van onze unificerende e-mail-API uitgebreid - authenticatiestromen, afhandelingsbeheer, map synchronisatie, zoekfilters en webhook-instellingen. Alles wat je nodig hebt om een productie-e-mailintegratie te bouwen.
Gemeenschappelijk gebruikssituaties
A unificerende e-mail-API is fundamentele infrastructuur voor een breed scala aan productcategorieën. Met een multi-provider e-mail-API, teams leveren sneller features op en bedienen meer gebruikers - ongeacht hun e-mailprovider. Dit zijn de patronen die het meest frequent met Unipile worden gebouwd.
Haal automatisch elke e-mail van klanten binnen in uw CRM-records. Verkopers zien de volledige conversatiegeschiedenis zonder ooit van tabblad te wisselen of handmatig door te sturen.
Verzend gepersonaliseerde opvolgsequenties vanuit de echte inboxen van uw gebruikers - niet vanuit een gedeeld verzenddomein - gelijktijdig via Gmail- en Outlook-accounts.
Recruiters koppelen hun zakelijke e-mail en uw ATS logt automatisch elke kandidaat-thread. Reageer rechtstreeks vanuit de ATS-interface, gerouteerd via hun echte Outlook- of Gmail-account.
Bouw een gedeelde inbox of helpdesk die e-mail van meerdere teamaccounts consolideert. Route, wijs toe en beantwoord - allemaal via één interface ondersteund door één API.
E-mailthreads invoeren in een LLM om conceptantwoorden, samenvattingen of actiepunten te genereren. Unipile levert de genormaliseerde threadgegevens; jouw AI-laag zorgt voor de redenering.
Activeer no-code workflows vanaf nieuwe e-mails van elke provider. Een webhook wordt geactiveerd voor elk inkomend bericht - uw automatiseringsplatform regelt de rest zonder te pollen.
Elk van deze patronen werkt in Gmail, Outlook en IMAP met nul provider-specifieke code in uw applicatie. Unipile normaliseert de verschillen, zodat uw productlogica schoon blijft en uw gebruikers elke gewenste inbox kunnen verbinden. Raadpleeg voor een volledige handleiding van elke endpoint de leidraad voor een uniforme e-mail-API.
Veelgestelde vragen vragen
Alles wat ontwikkelaars vragen voordat ze een multi-provider e-mail-API integreren.
id, onderwerp, van, naar, datumen lichaam hebben dezelfde structuur, ongeacht de provider. Uw parseerlogica, databasemodellen en downstreamverwerking hoeven nooit te splitsen op provider type.
Verbind Gmail-, Outlook- en IMAP-accounts via één enkele API. Geen OAuth-gedoe, geen schema-mapping, geen polling-infrastructuur om te onderhouden. Begin met een gratis proefperiode van 7 dagen - geen creditcard vereist.
NL 
EN 
FR 
ES 
DE 
IT 
BR 
PL 
TR