API v2 /emails endpointy jsou nyní k dispozici

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

Nové endpointy

Odeslání e-mailu

POST /v2/emails

Odešlete jeden e-mail 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 e-maily 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 e-mailem
• Idempotence – Zabraňte duplicitním odesláním pomocí hlavičky Idempotency-Key

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

Získání e-mailu

GET /v2/emails/{id}

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

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

Aktualizace naplánovaného e-mailu

POST /v2/emails/{id}

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

Zrušení e-mailu

POST /v2/emails/{id}/cancel

Zrušte naplánovaný nebo čekající e-mail před jeho odesláním. U naplánovaných e-mailů 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í e-mailu
• Získání e-mailu
• Aktualizace naplánovaného e-mailu
• Zrušení e-mailu

Připravuje se: Templates API

Pracujeme na Templates API, které vám umožní programově vytvářet, aktualizovat a spravovat e-mailové š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.