Přejít na obsah
Dokumentace

Rychlý začátek

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

Ověřte doménu, vytvořte API klíč a odešlete první e-mail přes cURL nebo oficiální SDK pro Node.js, Python, PHP, Ruby, Go, Javu, .NET nebo Rust.

Aktualizováno 1. 10. 2026

Tento rychlý začátek vás od nového účtu dovede k doručenému e-mailu zhruba za pět minut, plus čas, který váš poskytovatel DNS potřebuje ke zveřejnění záznamů. Ověříte doménu, vytvoříte API klíč, odešlete e-mail a najdete ho ve webovém rozhraní.

Než začnete

  • Účet v Emailitu. Zaregistrujte se na dash.emailit.com.
  • Doména, ke které můžete přidávat DNS záznamy, například acme.com. Můžete použít i subdoménu, například mail.acme.com.

Přidejte a ověřte doménu

Emailit odesílá jen z ověřených domén, aby poštovní servery příjemců mohly zkontrolovat, že e-mail opravdu pochází od vás.

  1. Přidejte doménu. Otevřete Email APIDomains, vyberte Add domain, zadejte acme.com a vyberte Create.

  2. Zveřejněte DNS záznamy. Stránka domény uvádí záznamy, které máte přidat u svého poskytovatele DNS. Zkopírujte z ní přesné hodnoty. Tři povinné záznamy vypadají takto:

    Typ Název Hodnota
    TXT emailit._domainkey.acme.com v=DKIM1; t=s; h=sha256; p=… (váš klíč)
    TXT emailit.acme.com v=spf1 include:_spf.emailit.com ~all
    MX emailit.acme.com, priorita 10 feedback-smtp.ffdc-1.emailit.com

    Pokud máte DNS v Cloudflare, můžete záznamy místo toho zveřejnit jedním kliknutím. Viz Nastavení DNS v Cloudflare.

  3. Zkontrolujte DNS. Vyberte Check DNS. Když SPF, DKIM a Return Path ukazují OK, má doména stav Verified. Většina poskytovatelů záznamy zveřejní během několika minut, ale může to trvat až 48 hodin.

V tarifu Pay as you go má doména registrovaná před méně než 30 dny stav Pending verification, dokud ji tým Emailitu nezkontroluje. Podrobnosti a volitelné záznamy pro DMARC, měření a příchozí poštu najdete na stránce Přidání odesílací domény.

Vytvořte API klíč

  1. Otevřete API klíče. Otevřete Email APIAPI Keys a vyberte Add API key.

  2. Pojmenujte klíč a zvolte rozsah oprávnění. Zadejte název, například Quickstart. Sending Only může jen odesílat e-maily. Full Access může volat i zbytek API. Pro tento rychlý začátek stačí kterýkoli z nich.

  3. Zkopírujte klíč. Vyberte Create a klíč zkopírujte. Začíná na secret_ a zobrazí se jen jednou.

  4. Uložte ho do proměnné prostředí, aby nebyl ve vašem kódu:

    Terminal
    export EMAILIT_API_KEY="secret_••••"

Odešlete e-mail

Nainstalujte SDK pro svůj jazyk, nebo použijte cURL:

Terminal
# cURL is preinstalled on macOS, Linux and Windows 10 or later
curl --version

Pak odešlete e-mail. Použijte adresu odesílatele na doméně, kterou jste ověřili, a e-mail pošlete na adresu, se kterou jste se zaregistrovali:

Terminal
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Hello from Emailit",
    "html": "<p>This is my first email sent with Emailit.</p>"
  }'

Přečtěte si odpověď

Úspěšný požadavek vrací 200 s novým e-mailem:

JSON
{
  "object": "email",
  "id": "em_2pX7cN4kQ9vLm3RtB8yWd1Zs",
  "token": "2pX7cN4m8FqT1vKz6RbL3HwYd",
  "message_id": "<2pX7cN4m8FqT1vKz6RbL3HwYd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Hello from Emailit",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418Z",
  "tracking": { "loads": false, "clicks": false }
}
Pole Význam
id ID e-mailu. Použijte ho k dohledání e-mailu, k jeho zrušení nebo opakovanému odeslání a k párování událostí webhooků.
status accepted znamená, že Emailit zařadil e-mail do fronty k doručení. Pokud nastavíte scheduled_at, je stav scheduled.
message_id Hlavička Message-ID e-mailu.
ids Uvádí se, jen pokud je příjemců víc. Přiřazuje každé adrese příjemce vlastní ID e-mailu.
tracking Jestli se u tohoto e-mailu měří otevření (loads) a prokliky. Měření potřebuje ověřenou subdoménu pro měření.

Stav accepted ještě neznamená doručení. Doručení probíhá na pozadí a stav se během něj mění.

Zkontrolujte e-mail ve webovém rozhraní

Otevřete Email APIEmails. Váš e-mail je nahoře na kartě Outgoing. Během několika sekund obvykle přejde ze stavu accepted do stavu delivered. Když ho otevřete, uvidíte hlavičky, obsah, každý pokus o doručení s odpovědí přijímajícího serveru a výsledky kontrol spamu.

Samotný požadavek se zobrazí v Email APILogs se stavovým kódem a tělem požadavku i odpovědi.

Řešení problémů

Odpověď Příčina Řešení
401 API key required nebo Invalid API key Chybí hlavička Authorization, nebo je klíč špatný Pošlete Authorization: Bearer secret_… s aktuálním klíčem
403 unverified_workspace_recipient Workspace je v režimu sandbox Odešlete e-mail na adresu účtu člena workspace, nebo požádejte o produkční přístup
422 From/Sender domain is not valid or not verified Doména odesílatele není v tomto workspace ověřená Ověřte doménu, nebo použijte adresu na ověřené doméně
403 Domain not authorized Klíč jen pro odesílání je omezený na jinou doménu Použijte klíč pro tuto doménu, nebo klíč bez omezení
402 Insufficient credits Workspace nemá dost kreditů Dokupte kredity
429 Rate limit exceeded Příliš mnoho e-mailů v této sekundě nebo dnes Počkejte dobu uvedenou v retry-after. Viz Limity rychlosti.

Další kroky

Dostávejte události doručení, nedoručení a otevření v reálném čase.
Navrhněte e-mail jednou ve webovém rozhraní a odesílejte ho podle aliasu s proměnnými.
Opakujte požadavky bezpečně, aniž byste odeslali e-mail dvakrát.
Co zkontrolovat, než začnete odesílat skutečným příjemcům.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.