Přejít na obsah
Dokumentace

Řešení problémů

Proč dostávám chybu 429 Rate limit exceeded?

Ošetřete odpovědi 429 z API Emailitu. Zjistěte, jak fungují limity odesílání za sekundu a za den, hlavičky limitů rychlosti a jak požádat o vyšší limity.

Aktualizováno 11. 10. 2026

Tento článek vysvětluje, proč POST /v2/emails vrací 429 a jak rozložit odesílání v čase, aby k tomu nedocházelo. Stejné limity platí pro SMTP, kde se projeví jako odpovědi 452.

Příznaky

API odpoví 429 s jedním z těchto těl:

JSON
{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Maximum 2 messages per second allowed.",
  "limit": 2,
  "current": 2,
  "retry_after": 1
}
JSON
{
  "error": "Daily limit exceeded",
  "message": "Daily sending limit of 5000 messages has been reached.",
  "limit": 5000,
  "current": 5000,
  "retry_after": 41200
}

Přes SMTP selže příkaz MAIL FROM s 452 4.4.5 Messages per second limit exceeded nebo 452 4.5.3 Daily message limit exceeded.

Příčina

Každý workspace má dva limity odesílání, které sdílejí všechny API klíče i SMTP:

  • Za sekundu. Nové workspace začínají na 2 e-mailech za sekundu.
  • Za den. Tarif Pay as you go začíná na 100 e-mailech za den a po prvním nákupu kreditů na 5 000. Tarify Pro a Business začínají na 5 000 a limit roste automaticky. Počítadlo se nuluje o půlnoci UTC.

API počítá každého příjemce jako jeden e-mail, takže požadavek se třemi adresami v to, cc a bcc spotřebuje tři, a celý požadavek se musí vejít do toho, co dnes zbývá. Obvyklou příčinou jsou nárazy z paralelních workerů, smyčky opakování bez odstupu a dávkové úlohy, které začínají ve stejnou chvíli.

Každá odpověď na odeslání obsahuje hlavičky, ze kterých poznáte, kde jste:

Hlavička Význam
ratelimit-limit / ratelimit-remaining Limit za sekundu a kolik z něj v aktuální sekundě zbývá
ratelimit-daily-limit / ratelimit-daily-remaining Denní limit a kolik z něj dnes zbývá
ratelimit-daily-reset Počet sekund do půlnoci UTC
retry-after Kolik sekund počkat před dalším pokusem (jen u 429)

Řešení

  1. Počkejte a zkuste to znovu. Než odešlete další požadavek, respektujte retry-after (nebo retry_after v těle). Požadavek s 429 se neodeslal ani nezaúčtoval, takže jeho zopakování je bezpečné. Proti opakování na úrovni sítě se chraňte hlavičkou Idempotency-Key.

  2. Hlídejte tempo odesílání. Použijte frontu s limitem souběhu, který odpovídá ratelimit-limit, a po 429 zvyšujte odstup exponenciálně, místo abyste požadavek opakovali v rychlé smyčce.

  3. Rozložte velká odeslání. Pokud narazíte na denní limit, naplánujte zbytek pomocí scheduled_at na dobu po půlnoci UTC, nebo pro marketingovou poštu použijte kampaň.

  4. Zkontrolujte aktuální limity. Panel Sending Limits na stránce Dashboard ukazuje vaše limity za sekundu a za den a dnešní využití.

  5. Požádejte o vyšší limity. V bezplatném workspace v tarifu Pay as you go si kupte kredity a limit se zvýší ze 100 na 5 000 e-mailů denně. Jinak v panelu Sending Limits vyberte Request increase, zvolte, o kolik víc potřebujete (+5 000, +10 000 nebo +15 000 e-mailů denně, nebo víc), a napište nám, co odesíláte a odkud pocházejí vaši příjemci. Požádat můžete jednou za 7 dní a tým obvykle odpoví do 24 hodin. V tarifech Pro a Business se limit navyšuje také automaticky, když ho využíváte s nízkou mírou nedoručení.

Úplnou referenci najdete na stránce Limity rychlosti a všechny kvóty tarifů na stránce Limity.

Stále si nevíte rady?

Napište podpoře nebo se zeptejte na Discordu. Uveďte očekávaný objem za den a za sekundu a ukázkovou odpověď 429.

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

Děkujeme za zpětnou vazbu.

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