MailLandDocs
Erste Schritte

Einführung

Erfahren Sie, was Mail.Land ist und wie es Ihnen beim Versand von transaktionalen und Marketing-E-Mails in großem Umfang helfen kann

MailLand ist eine B2B-E-Mail-Zustellplattform, die für Entwickler und Unternehmen entwickelt wurde, die einen zuverlässigen E-Mail-Versand in großen Mengen benötigen. Ob Sie Passwortzurücksetzungen, Bestellbestätigungen, Newsletter oder Marketing-Kampagnen versenden: MailLand stellt die Infrastruktur bereit, damit Ihre E-Mails im Posteingang ankommen.

Was Mail.Land leistet

MailLand verarbeitet zwei Kategorien von E-Mails:

Transaktionale E-Mails: ausgelöst durch Benutzeraktionen. Passwortzurücksetzungen, Bestellbestätigungen, Kontobenachrichtigungen, Zwei-Faktor-Codes. Diese sind zeitkritisch und erfordern eine hohe Zustellbarkeit.

Marketing-E-Mails: Massenversand an Abonnentenlisten. Newsletter, Produktankündigungen, Werbeaktionen, Drip-Kampagnen. Diese erfordern Listenverwaltung, Segmentierung und Compliance-Werkzeuge.

Beide nutzen die gleiche Infrastruktur, sind jedoch auf Credential-Ebene getrennt. Ein transaktionales Credential kann keine Marketing-Massen-E-Mails versenden und umgekehrt. Diese Trennung schützt Ihre Absender-Reputation.

Hauptfunktionen

Versand

  • REST API: Versenden Sie einzelne E-Mails über POST /v1/transactional/send mit JSON-Payloads. Unterstützt HTML, Klartext, Templates, Anhänge und empfängerspezifische Variablen.
  • SMTP Relay: Verbinden Sie Ihre bestehende Anwendung über SMTP auf Port 587 (STARTTLS). Authentifizieren Sie sich mit Ihrem API Key.
  • Batch-Versand: Senden Sie an mehrere Empfänger in einem einzigen API-Aufruf über POST /v1/transactional/send-batch. Nur für Marketing-Credentials.
  • Geplante E-Mails: Planen Sie E-Mails bis zu 7 Tage im Voraus. scheduledAt wird immer als UTC interpretiert.
  • Templates: Erstellen Sie wiederverwendbare E-Mail-Vorlagen mit Variablenersetzung in {{variable}}-Syntax.

Domains und Zustellbarkeit

  • Domain-Verifizierung: Bestätigen Sie die Inhaberschaft mit SPF-, DKIM- und DMARC-DNS-Einträgen. MailLand generiert DKIM-Schlüssel automatisch.
  • DKIM-Signatur: MailLand erstellt für jede Domain einen DKIM-Schlüssel und signiert jede Nachricht damit. Die Rotation des Schlüssels ist vorübergehend nicht verfügbar; siehe DKIM-Schlüsselrotation.
  • DNS-Integritätsüberwachung: Kontinuierliche Hintergrundprüfungen der DNS-Konfiguration mit Schweregrad-basierter Benachrichtigung.
  • Unterdrückungsverwaltung: Automatische Bounce- und Beschwerdebehandlung zum Schutz Ihrer Absender-Reputation.

Analysen und Webhooks

  • Echtzeit-Tracking: Öffnungs- und Klick-Tracking mit Granularität auf E-Mail-Ebene.
  • Webhooks: Empfangen Sie HTTP-Callbacks für Zustellung, Verzögerung, Bounce, Beschwerde und andere Ereignisse.
  • E-Mail-Protokolle: Durchsuchbare Protokolle jeder versendeten E-Mail mit Status, Zeitstempeln und Ereignisverlauf.

Konto und Sicherheit

  • Multi-Tenant-Workspaces: Organisieren Sie Domains, Credentials und Teammitglieder in separaten Workspaces.
  • API Key Scoping: Beschränken Sie Credentials nach Domain, IP-Adresse und Kanal (API/SMTP).
  • Zwei-Faktor-Authentifizierung: TOTP-basierte 2FA für Kontosicherheit.
  • Sandbox-Modus: Testen Sie Ihre Integration, ohne echte E-Mails zu versenden. Sandbox-Credentials nehmen den Versand an und protokollieren ihn, stellen aber nicht zu, oder stellen nur an Adressen Ihrer Sandbox-Zulassungsliste zu. Neue Workspaces sind bis zur Verifizierung ebenfalls auf diese Liste beschränkt.

Funktionsweise

Der allgemeine Ablauf für den Versand einer E-Mail:

  1. Authentifizieren: Fügen Sie Ihren API Key im X-API-Key-Header (REST) ein oder verwenden Sie ihn als SMTP-Passwort.
  2. Senden: Senden Sie Ihre E-Mail per POST an die API oder leiten Sie sie über SMTP weiter.
  3. Einreihen: MailLand validiert die Anfrage, prüft Ratenlimits und Kontingente und reiht die E-Mail in die Warteschlange ein.
  4. Zustellen: Die E-Mail wird verarbeitet, mit DKIM signiert und an den Mailserver des Empfängers zugestellt.
  5. Verfolgen: Zustellungs-, Verzögerungs-, Bounce-, Beschwerde- und Inbound-Ereignisse werden aufgezeichnet und über Webhooks weitergeleitet.

Antworten auf Sendevorgänge enthalten eine jobId oder messageId, mit der Sie die E-Mail über ihren gesamten Lebenszyklus verfolgen können.

Credential-Streams

MailLand erzwingt eine strikte Trennung zwischen transaktionalen und Marketing-E-Mails:

EigenschaftTransactionalMarketing
Max. Empfänger pro Versand51.000 (10.000 pro Batch)
Batch-VersandNicht erlaubtErlaubt
RatenlimitsUnabhängigUnabhängig
Message-ID-Präfixt_m_
AnwendungsfallPasswortzurücksetzungen, Quittungen, OTPsNewsletter, Werbeaktionen, Kampagnen

Diese Trennung wird auf Credential-Ebene durchgesetzt. Wenn Sie ein Credential erstellen, wählen Sie einen Stream, Transactional oder Marketing. Der Stream bestimmt, welche Operationen verfügbar sind.

Nächste Schritte

Auf dieser Seite