Gebäude bauen Multi-Provider-E-Mail-API Integration, die über Gmail, Outlook und IMAP hinweg funktioniert, ist eine der zeitaufwendigsten Herausforderungen für Entwicklungsteams. Jeder Anbieter liefert seinen eigenen OAuth-Flow, seine eigenen Ratenbegrenzungen und sein eigenes Datenmodell. Ein Vereinheitlichte E-Mail-API fasst all dies in einer einzigen REST-Schnittstelle zusammen – Sie schreiben also eine Integration und erhalten Abdeckung für jeden wichtigen Posteingang, auf den Ihre Benutzer angewiesen sind.
Was Sie lernen werden
Vollständiger Leitfaden zur E-Mail-API
Erfahren Sie, wie Gmail, Outlook und IMAP unter einer einzigen, vereinheitlichten REST-API zusammenarbeiten.
Warum Entwickler eine Multi-Provider-E-Mail-API benötigen
Die meisten SaaS-Produkte müssen letztendlich E-Mails im Namen ihrer Benutzer lesen oder versenden. Das Problem ist nicht das Konzept – es ist die Ausführung. Gmail verwendet die Gmail API mit Google OAuth 2.0. Outlook verwendet Microsoft Graph mit seinem eigenen Token-Lebenszyklus. IMAP-basierte Anbieter verhalten sich jeweils etwas anders. Der Aufbau und die Wartung von drei separaten Integrationen verbrauchen Entwicklungszyklen, die für Ihr Kernprodukt verwendet werden sollten. Wenn Sie speziell mit IMAP-Konten zu tun haben, IMAP API-Leitfaden deckt die zusätzliche Komplexität ab, die sich ergibt. Eine Vereinheitlichte E-Mail-API löst dies, indem die anbieterspezifische Komplexität hinter einer einzigen Schnittstelle zusammengefasst wird – das ist das Kernversprechen eines Multi-Provider-E-Mail-API Ansatz. Für eine vollständige technische Referenz zur Vorgehensweise E-Mail senden API Anrufe über Gmail, Outlook und IMAP, siehe unsere spezielle Anleitung.
Die 3 E-Mail-Anbieter gedeckt
Eine einheitliche API normalisiert Gmail, Outlook und IMAP zu einer identischen Schnittstelle. Ihr Code ändert sich nie, wenn ein Benutzer einen anderen Anbieter anschließt.
Verbinden Sie jedes Gmail- oder Google Workspace-Konto über Google OAuth 2.0. Senden, lesen, suchen und synchronisieren Sie Threads in Echtzeit über die Unipile-Schicht – keine direkten Gmail-API-Anmeldeinformationen in Ihrer App erforderlich.
Unterstützt persönliche Outlook-Konten, Microsoft 365 und Exchange Online unter einem einzigen Anbieter-Handle. Microsoft OAuth wird von Unipile verwaltet – Ihre Integration bleibt über Tenant-Konfigurationen hinweg stabil.
Jede über IMAP erreichbare Mailbox – Yahoo, Fastmail, ProtonMail Bridge, benutzerdefinierte Unternehmensserver – wird sofort über dieselbe API-Oberfläche zugänglich, die für Gmail und Outlook verwendet wird.
Unipile gegen Selbst bauen
Was kostet es eigentlich, einen [Objekt] selbst zu bauen? Multi-Provider-E-Mail-API Integration? Hier ist ein ehrlicher Vergleich über die Dimensionen, die in der Produktion wichtig sind. Deshalb entscheiden sich Teams zunehmend für ein Vereinheitlichte E-Mail-API anstatt jede Anbieterintegration von Grund auf neu zu entwickeln.
Wie die Integration Arbeiten
Das Verbinden Ihres ersten E-Mail-Kontos mit Unipile erfordert vier Schritte. Der gleiche Ablauf funktioniert, unabhängig davon, ob der Benutzer ein Gmail-, Outlook- oder IMAP-Konto - Ihr Anwendungscode bleibt durchgängig identisch. Dies ist die praktische Stärke einer einheitlichen E-Mail-API: einmal schreiben, alle drei Anbieter abdecken.
Ihr Backend ruft die Unipile API auf, um eine kurzlebige gehostete Authentifizierungs-URL zu erstellen. Leiten Sie den Benutzer zu dieser URL weiter – Unipile präsentiert den Anbieter-Auswahlbildschirm und übernimmt den gesamten OAuth-Flow in Ihrem Namen.
POST /api/v1/hosted/accounts/link const res = await fetch('https://api5.unipile.com:13515/api/v1/hosted/accounts/link', { Methode: 'POST', Header: { 'X-API-KEY': process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, körper: JSON.stringify({ Typ: 'E-MAIL', Anbieterfilter: ['GOOGLE', 'MICROSOFT', 'IMAP'], Erfolgs-Weiterleitungs-URL: 'https://your-app.com/auth/success' }) }); const { URL } = await res.json(); // leitet Benutzer zu `url` weiter
Sobald der Nutzer OAuth abgeschlossen hat, sendet Unipile einen Webhook an Ihr Endpunkt (oder hängt die Account-ID an Ihre Weiterleitungs-URL an). Speichern Sie diese Account-ID – sie ist Ihre permanente Referenz auf dieses verknüpfte Konto, unabhängig vom Anbieter.
{
"Ereignis": "Konto.verbunden",
"Konto_ID": "acc_01HXYZ...",
"Anbieter": "GOOGLE",
"E-Mail": "alice@gmail.com"
}
Verwenden Sie die Konto-ID, um E-Mails aufzulisten, zu suchen und abzurufen. Dies ist die Vereinheitlichte E-Mail-API in Aktion: das Antwortschema ist identisch, egal ob das Konto Gmail, Outlook oder IMAP ist – Ihre Parsing-Logik verzweigt nie nach Anbieter.
// GET /api/v1/emails?account_id=acc_01HXYZ... const emails = await fetch( `https://api5.unipile.com:13515/api/v1/emails?account_id=${Kontoname}&limit=20, { Kopfzeilen: { 'X-API-KEY': process.env.UNIPILE_API_KEY } } ).dann(r => r.json()); // Gleiche Antwortstruktur für Gmail, Outlook, IMAP: // { id, betreff, von, an, datum, inhalt, anhänge }
Ein einzelner POST-Endpunkt sendet E-Mails unabhängig vom Anbieter des Kontos – das ist die volle Stärke eines Multi-Provider-E-Mail-API. Übergeben Sie die Konto-ID, den Empfänger, den Betreff und den Nachrichtentext – Unipile leitet über die Gmail API, Microsoft Graph oder SMTP entsprechend weiter. Dies ist die Vereinheitlichte E-Mail-API in seiner konkretesten Form: ein Endpunkt, drei Anbieter, keine Verzweigung in Ihrem Code.
// POST /api/v1/emails/send await fetch('https://api5.unipile.com:13515/api/v1/emails/send', { Methode: 'POST', Header: { 'X-API-KEY': process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, körper: JSON.stringify({ account_id: 'acc_01HXYZ...', zu: [{ E-Mail: 'bob@example.com' }], Thema: 'Hallo von Unipile', Körper: 'Funktioniert mit Gmail, Outlook und IMAP.
' }) });
Wie Anbieterabstraktion Arbeiten
Die einheitliche E-Mail-API sitzt zwischen Ihrer Anwendung und den drei zugrunde liegenden Anbieterprotokollen und übersetzt unterschiedliche OAuth-Flows, Datenschemata und Ratenbegrenzungsmodelle in eine einzige konsistente Schnittstelle.
Gmail nutzt Google OAuth 2.0 mit einem spezifischen Token-Aktualisierungszyklus und gibt E-Mails in einem Thread-zentrierten Modell mit Labels zurück. Outlook nutzt Microsoft Graph mit einem anderen OAuth-Tenant-Modell und gibt E-Mails als einzelne Nachrichtenobjekte mit Ordnern zurück. IMAP-Server haben jeweils eigene Verbindungsparameter, Authentifizierungsmethoden und Fähigkeitssätze.
Unipile's Vereinheitlichte E-Mail-API normalisiert alle drei in eine einzige REST-Schnittstelle. Ihr Code ruft /api/v1/emails und identisch geformte Antwortobjekte empfängt – unabhängig davon, ob das zugrundeliegende Konto ein Gmail-, Outlook- oder IMAP-Konto ist. Das Gleiche gilt für das Senden, die Handhabung von Anhängen, Webhook-Ereignisse und die Verwaltung des Konto-Lebenszyklus.
Dies ist der zentrale technische Vorteil von Multi-Provider-E-Mail-API Die Komplexität wird auf der Infrastrukturebene absorbiert, nicht in Ihrem Anwendungscode. Wenn Google seine OAuth Scope-Anforderungen ändert oder Microsoft die Paginierung der Graph API aktualisiert, kümmert sich Unipile um die vorgelagerte Änderung – Ihre Integration bleibt intakt.
Sicherheit und Compliance
Wenn Ihre Anwendung im Namen von Benutzern E-Mails verarbeitet, ist Sicherheit nicht optional. Hier erfahren Sie, wie die einheitliche API-Schicht für E-Mails Anmeldeinformationen, Daten und Compliance-Verpflichtungen verwaltet.
Unipile speichert und aktualisiert OAuth-Token in Ihrem Auftrag. Ihre Anwendung verarbeitet niemals rohe Anmeldeinformationen – Sie arbeiten nur mit undurchsichtigen Konto-IDs. Token-Rotation, Erkennung des Ablaufs und Re-Authentifizierungsflüsse werden vollständig auf der Infrastrukturebene verwaltet.
Alle Daten während der Übertragung nutzen TLS 1.3. Gespeicherte Anmeldedaten werden bei der Speicherung mit AES-256 verschlüsselt. E-Mail-Inhalte, die über die einheitliche E-Mail-API abgerufen werden, werden im Arbeitsspeicher verarbeitet und nicht länger als von Ihrer Integration explizit angefordert gespeichert.
Unipile ist SOC 2 Typ II-zertifiziert (Oktober 2025). Unabhängige Prüfer haben die Sicherheit, Verfügbarkeit und Vertraulichkeit der Plattform verifiziert. Prüfberichte sind auf Anfrage für Unternehmenskunden erhältlich, die die Multi-Provider-E-Mail-API für den Produktionseinsatz bewerten.
Datenverarbeitungsvereinbarungen sind für alle Pläne verfügbar. Die Option für den Wohnsitz der Daten in der EU wird für Kunden mit Anforderungen an die Datenlokalisierung angeboten. Das Recht auf Löschung wird über die API unterstützt: Das Löschen eines verknüpften Kontos entfernt alle zugehörigen Token und zwischengespeicherten Daten.
Validierung von Sicherheitskontrollen für Anwendungen, die auf Google-Nutzerdaten zugreifen, einschließlich Gmail OAuth-Berechtigungen. Auf Unipile basierende Apps übernehmen diese Zertifizierung.
Uptime und Incident-Historie sind öffentlich verfügbar unter status.unipile.com. Alle API-Änderungen folgen einer Versionierungsrichtlinie mit Deprecation-Hinweisen. Keine stillen Breaking Changes: Ihre Integration ist durch einen stabilen, dokumentierten Vertrag geschützt.
Handhabung Randfälle Anbieterübergreifend
Jede Produktions-E-Mail-Integration stößt auf anbieterspezifische Ausnahmefälle. Hier ist ein Vergleich eines DIY-Ansatzes mit der Verwendung einer einheitlichen E-Mail-API, wenn die Dinge kompliziert werden.
| Szenario | DIY-Ansatz | Unipile-Ansatz |
|---|---|---|
| Gmail Ratenbegrenzung 250 Quoten-Einheiten/Tag kostenlose Stufe |
Manuelle Überwachung der Kontingente pro Konto; Anfragen schlagen ohne Benachrichtigung fehl, wenn sie nicht überwacht werden | Automatisch bearbeitet Warteschlangen-Erstellung integriert, keine fehlgeschlagenen Anfragen sind bei Ihrer App aufgetreten |
| OAuth-Token-Ablauf | Implementieren Sie separate Aktualisierungslogik pro Anbieter: Die Token-Rotation unterscheidet sich zwischen Google und Microsoft | Automatisches Auffrischen Zero-Downtime-Tokenverwaltung über alle Anbieter hinweg |
| IMAP-Verbindung bricht ab | Benutzerdefinierte Wiederverbindungslogik pro Serverkonfiguration; Timeouts variieren zwischen IMAP-Implementierungen | Verbindungspool verwaltet Dauerhafte Verbindungen, die von der Unipile-Infrastruktur aufrechterhalten werden |
| Anhange Größe begrenzt Gmail 25 MB, Outlook 150 MB, IMAP variiert |
Anbieterübergreifender Verzweigungscode; muss das Limit jedes Anbieters verfolgen und aktualisieren, wenn es sich ändert | Vereinheitlichte Validierung Anbieterunabhängige Größenvalidierung; Fehler werden in einem konsistenten Schema zurückgegeben |
| Änderungen an der Anbieter-API | Ihre Bereitschaftsdienstverantwortung; Google und Microsoft setzen Änderungen mit begrenzter Vorankündigung durch | Bearbeitet vom Unipile-Team Upstream-Änderungen auf Infrastrukturebene übernommen; Ihre Integration bleibt stabil |
Gmail Ratenbegrenzung
250 Quoten-Einheiten/Tag kostenlose StufeManuelle Überwachung der Kontingente pro Konto; Anfragen schlagen ohne Benachrichtigung fehl, wenn sie nicht überwacht werden
Die Säulenführung deckt jeden Endpunkt unserer Vereinheitlichte E-Mail-API umfassend – Authentifizierungsflüsse, Anhangsverwaltung, Ordnersynchronisierung, Suchfilter und Webhook-Einrichtung. Alles, was Sie für die Erstellung einer produktionsreifen E-Mail-Integration benötigen.
Gemeinsam Anwendungsfälle
A Vereinheitlichte E-Mail-API ist grundlegende Infrastruktur für eine breite Palette von Produktkategorien. Mit einer Multi-Provider-E-Mail-API, Teams liefern Funktionen schneller aus und bedienen mehr Benutzer – unabhängig davon, welchen E-Mail-Provider sie verwenden. Hier sind die Muster, die am häufigsten mit Unipile erstellt werden.
Ziehen Sie automatisch jede Kunden-E-Mail in Ihre CRM-Datensätze. Vertriebsmitarbeiter sehen die vollständige Konversationshistorie, ohne jemals den Tab wechseln oder manuell weiterleiten zu müssen.
Senden Sie personalisierte Folge-E-Mails aus den echten Postfächern Ihrer Nutzer – nicht von einer gemeinsamen Sending-Domain – gleichzeitig über Gmail und Outlook-Konten.
Recruiter verknüpfen ihre Arbeits-E-Mail und Ihr ATS zeichnet jeden Kandidaten-Thread automatisch auf. Antworten Sie direkt aus der ATS-Oberfläche, geleitet über Ihr echtes Outlook- oder Gmail-Konto.
Bauen Sie einen gemeinsamen Posteingang oder Helpdesk, der E-Mails von mehreren Teamkonten konsolidiert. Routen, zuweisen und antworten – alles über eine einzige Schnittstelle, unterstützt von einer einzigen API.
E-Mail-Threads in ein LLM einspeisen, um Entwurfsantworten, Zusammenfassungen oder Aktionspunkte zu generieren. Unipile stellt die normalisierten Thread-Daten bereit; Ihre KI-Schicht übernimmt die logische Verarbeitung.
Lösen Sie No-Code-Workflows durch neue E-Mails von jedem Anbieter aus. Für jede eingehende Nachricht wird ein Webhook ausgelöst – Ihre Automatisierungsplattform kümmert sich um den Rest, ohne Abfragen.
Jedes dieser Muster funktioniert in Gmail, Outlook und IMAP ohne anwendungsspezifischen Code von Drittanbietern in Ihrer Anwendung. Unipile normalisiert die Unterschiede, sodass Ihre Produktlogik sauber bleibt und Ihre Benutzer jede beliebige Posteingangsart verbinden können. Eine vollständige Anleitung zu jedem Endpunkt finden Sie in den Leitfaden für eine einheitliche E-Mail-API.
Häufig gestellte Fragen Fragen
Alles, was Entwickler fragen, bevor sie eine Multi-Provider-E-Mail-API integrieren.
id, Thema, from, zu, Datumund Körper haben die gleiche Struktur, unabhängig vom Anbieter. Ihre Parsing-Logik, Datenbankmodelle und nachgelagerten Verarbeitungsschritte müssen niemals nach Anbieter-Typ verzweigt werden.
Verbinden Sie Gmail-, Outlook- und IMAP-Konten über eine einzige API. Keine OAuth-Umständlichkeiten, kein Schema-Mapping, keine abzufragende Infrastruktur, die unterhalten werden muss. Starten Sie mit einer 7-tägigen kostenlosen Testversion – keine Kreditkarte erforderlich.