Erste E-Mail per SMTP senden

Dieser Schnellstart zeigt, wie Sie eine Test-E-Mail aus Ihrem Terminal über das SMTP-Relay von Emailit senden und dann Ihre eigene App verbinden. Verwenden Sie SMTP, wenn Ihre Software bereits SMTP-Einstellungen hat. Für neuen Code bietet die API mehr.

Voraussetzungen

• Eine verifizierte Versanddomain. Wenn Sie noch keine haben, folgen Sie dem ersten Abschnitt des API-Schnellstarts oder der Anleitung Versanddomain hinzufügen.
• Ein API-Schlüssel. Erstellen Sie einen unter Email API›API Keys mit Add API key. Ihr API-Schlüssel ist Ihr SMTP-Passwort.

Ihre SMTP-Zugangsdaten

Diese Einstellungen sehen Sie auch auf der Karte SMTP Info, wenn Sie einen Schlüssel unter Email API›API Keys öffnen.

Das Relay bietet TLS auf jedem Port an, erzwingt es aber nicht. Aktivieren Sie TLS in Ihrem Client immer, damit Ihr API-Schlüssel nicht im Klartext gesendet wird.

Test-E-Mail senden

Wählen Sie eines dieser Tools. Ersetzen Sie hello@acme.com durch eine Adresse auf Ihrer verifizierten Domain und ada@example.com durch die E-Mail-Adresse, mit der Sie sich registriert haben.

swaks

swaks ist ein Kommandozeilen-Tool zum Testen von SMTP. Installieren Sie es mit brew install swaks oder apt install swaks und führen Sie dann Folgendes aus:

swaks --server smtp.emailit.com:587 --tls \
  --auth-user emailit --auth-password "$EMAILIT_API_KEY" \
  --from hello@acme.com --to ada@example.com \
  --header "Subject: Hello from Emailit SMTP" \
  --body "This is my first email sent through the Emailit SMTP relay."

swaks gibt die gesamte SMTP-Unterhaltung aus. Die letzte Antwort des Servers enthält die E-Mail-ID:

<~  250 2.0.0 OK: queued as em_2pX7cN4kQ9vLm3RtB8yWd1Zs

OpenSSL

OpenSSL ist auf den meisten Systemen vorinstalliert und lässt Sie die SMTP-Befehle selbst eingeben. Kodieren Sie zuerst Ihre Zugangsdaten für AUTH PLAIN:

printf '\0emailit\0%s' "$EMAILIT_API_KEY" | base64

Öffnen Sie dann eine Verbindung und geben Sie die folgenden Befehle ein; fügen Sie dabei die kodierte Zeichenfolge nach AUTH PLAIN ein:

openssl s_client -connect smtp.emailit.com:587 -starttls smtp -crlf -quiet

EHLO localhost
AUTH PLAIN AGVtYWlsaXQAc2VjcmV0X...
MAIL FROM:<hello@acme.com>
RCPT TO:<ada@example.com>
DATA
From: Acme <hello@acme.com>
To: ada@example.com
Subject: Hello from Emailit SMTP

This is my first email sent through the Emailit SMTP relay.
.
QUIT

Nach AUTH PLAIN antwortet der Server mit 235. Nach der Zeile mit einem einzelnen . antwortet er mit 250 2.0.0 OK: queued as em_….

Python

Das integrierte smtplib von Python braucht keine zusätzlichen Pakete:

import os
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "ada@example.com"
msg["Subject"] = "Hello from Emailit SMTP"
msg.set_content("This is my first email sent through the Emailit SMTP relay.")
msg.add_alternative("<p>This is my first email sent through the Emailit SMTP relay.</p>", subtype="html")

with smtplib.SMTP("smtp.emailit.com", 587) as smtp:
    smtp.starttls()
    smtp.login("emailit", os.environ["EMAILIT_API_KEY"])
    smtp.send_message(msg)

print("Accepted by Emailit")

Wenn das Skript ohne Exception durchläuft, hat Emailit die E-Mail angenommen.

In der Weboberfläche prüfen

Öffnen Sie Email API›Emails. Ihre E-Mail steht oben im Tab Outgoing, und ihr Status wechselt von accepted zu delivered, sobald der Server des Empfängers sie annimmt. Jede SMTP-Sitzung erscheint außerdem unter Email API›Logs mit der Quelle SMTP, sodass Sie auch fehlgeschlagene Anmeldungen und abgelehnte Nachrichten sehen.

Häufige Antworten

Alle Antwortcodes finden Sie unter SMTP-Fehlerbehebung.

App verbinden

Tragen Sie dieselben Einstellungen in Ihre App oder Ihr Framework ein. Diese Anleitungen zeigen die genaue Konfiguration:

Nächste Schritte