Odeslání prvního e-mailu přes SMTP

Tento rychlý začátek ukazuje, jak z terminálu odeslat testovací e-mail přes SMTP relay Emailitu a pak připojit vlastní aplikaci. SMTP použijte, když váš software už má nastavení SMTP. Pro nový kód toho API umí víc.

Než začnete

• Ověřená odesílací doména. Pokud ji ještě nemáte, postupujte podle první části rychlého začátku s API nebo podle stránky Přidání odesílací domény.
• API klíč. Vytvořte ho v Email API›API Keys tlačítkem Add API key. Váš API klíč je vaše heslo k SMTP.

Vaše přístupové údaje k SMTP

Tato nastavení uvidíte také v panelu SMTP Info, když otevřete klíč v Email API›API Keys.

Relay nabízí TLS na každém portu, ale nevynucuje ho. Ve svém klientovi TLS vždy zapněte, aby se váš API klíč neposílal jako prostý text.

Pošlete testovací e-mail

Vyberte si jeden z těchto nástrojů. Nahraďte hello@acme.com adresou na své ověřené doméně a ada@example.com e-mailovou adresou, se kterou jste se zaregistrovali.

swaks

swaks je nástroj pro testování SMTP z příkazové řádky. Nainstalujte ho příkazem brew install swaks nebo apt install swaks a pak spusťte:

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 vypíše celou SMTP komunikaci. Poslední odpověď serveru obsahuje ID e-mailu:

<~  250 2.0.0 OK: queued as em_2pX7cN4kQ9vLm3RtB8yWd1Zs

OpenSSL

OpenSSL je předinstalovaný na většině systémů a umožňuje vám psát příkazy SMTP ručně. Nejdřív zakódujte své přístupové údaje pro AUTH PLAIN:

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

Pak otevřete spojení a napište příkazy níže; za AUTH PLAIN vložte zakódovaný řetězec:

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

Po AUTH PLAIN server odpoví 235. Po řádku s jedinou . odpoví 250 2.0.0 OK: queued as em_….

Python

Vestavěná knihovna smtplib v Pythonu nepotřebuje žádné další balíčky:

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")

Pokud skript skončí bez výjimky, Emailit e-mail přijal.

Zkontrolujte ho ve webovém rozhraní

Přejděte do Email API›Emails. Váš e-mail je nahoře na kartě Outgoing a jeho stav se změní z accepted na delivered, jakmile ho přijme server příjemce. Každá SMTP relace se také zobrazí v Email API›Logs se zdrojem SMTP, takže uvidíte i neúspěšná přihlášení a odmítnuté zprávy.

Časté odpovědi

Všechny kódy odpovědí najdete na stránce Řešení problémů se SMTP.

Připojte svou aplikaci

Zadejte stejná nastavení do své aplikace nebo frameworku. Přesnou konfiguraci ukazují tyto návody:

Další kroky