API v2 /emails endpointy jsou nyní k dispozici

S radostí oznamujeme, že emailové endpointy jsou nyní dostupné v API v2! Nyní můžete odesílat, načítat, aktualizovat naplánované emaily a rušit čekající emaily — vše prostřednictvím našeho výkonného REST API.

Nové endpointy

Odeslání emailu

POST /v2/emails

Odešlete jeden email jednomu nebo více příjemcům. Endpoint pro odesílání podporuje:

• Více příjemců — Odesílejte až 50 příjemcům (TO, CC, BCC dohromady)
• Šablony — Používejte aliasy nebo ID šablon s nahrazováním proměnných pomocí syntaxe {{proměnná}}
• Přílohy — Připojujte soubory prostřednictvím base64 obsahu nebo URL
• Plánování — Naplánujte emaily pro budoucí doručení pomocí ISO 8601, Unix timestampů nebo přirozeného jazyka jako „zítra v 9 ráno"
• Sledování — Přepište výchozí nastavení sledování domény pro otevření a kliknutí
• Metadata — Připojte vlastní páry klíč-hodnota, které se ukládají a vrací s emailem
• Idempotence — Zabraňte duplicitním odesláním pomocí hlavičky Idempotency-Key

Každý příjemce obdrží své vlastní jedinečné ID emailu pro individuální sledování při odesílání na více adres.

Získání emailu

GET /v2/emails/{id}

Načtěte podrobné informace o konkrétním emailu, včetně:

• Aktuální stav (čekající, naplánovaný, odeslaný, doručený, vrácený, zrušený)
• Surové hlavičky a obsah emailu
• Nastavení sledování
• Vlastní metadata
• Časové značky pro vytvoření a aktualizace

Aktualizace naplánovaného emailu

POST /v2/emails/{id}

Přeplánujte email, který je nastaven pro budoucí doručení. Můžete změnit naplánovaný čas, pokud je email alespoň 3 minuty před odesláním.

Zrušení emailu

POST /v2/emails/{id}/cancel

Zrušte naplánovaný nebo čekající email před jeho odesláním. U naplánovaných emailů musí být zrušení požadováno alespoň 3 minuty před naplánovaným časem odeslání.

Omezení rychlosti

Každá odpověď obsahuje hlavičky omezení rychlosti, takže můžete sledovat své využití:

• ratelimit-limit — Maximální počet požadavků za sekundu
• ratelimit-remaining — Zbývající požadavky v aktuální sekundě
• ratelimit-daily-limit — Maximální denní počet požadavků
• ratelimit-daily-remaining — Zbývající denní požadavky

Dokumentace

Kompletní dokumentace s příklady kódu v Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET a cURL je k dispozici:

• Odeslání emailu
• Získání emailu
• Aktualizace naplánovaného emailu
• Zrušení emailu

Připravuje se: Templates API

Pracujeme na Templates API, které vám umožní programově vytvářet, aktualizovat a spravovat emailové šablony. Zůstaňte naladěni na tento vzrušující přírůstek!

Oznámení o ukončení podpory API v1

Důležité: API v1 bylo označeno jako zastaralé a přestane fungovat na konci února 2026. Pokud stále používáte API v1, přemigrujte na API v2 co nejdříve.

Potřebujete pomoc s migrací? Podívejte se na naši dokumentaci API v2 nebo se obraťte na náš tým podpory.