API vrací chybu 429: jak navrhnout integraci, která zvládne limity služby

API vrací chybu 429: jak navrhnout integraci, která zvládne limity služby

Noční synchronizace místo pěti tisíc produktů přenese jen část a zbytek skončí na omezení počtu požadavků. HTTP 429 obvykle znamená překročení limitu služby. Správnou reakcí není posílat stejný požadavek stále rychleji, ale řídit tok práce a zachovat přehled o nedokončených položkách.

Zjistěte, co poskytovatel skutečně omezuje

Limit může platit pro klíč, účet, organizaci, konkrétní operaci nebo objem dat. Dvě integrace sdílející účet se mohou ovlivňovat, i když každá samostatně vypadá úsporně. Dokumentace má říct také to, zda služba oznamuje další povolený termín například hlavičkou Retry-After.

Využijte podporované dávkové operace a změnové přenosy místo opakovaného čtení celého katalogu. Počet požadavků ale nesnižujte za cenu ztráty kontroly: u dávky potřebujete znát výsledek každé položky a možnost bezpečného opakování.

Oddělte přijetí úkolu a jeho provedení

Fronta umožní přijmout objednávku, i když účetní systém dočasně zpomaluje. Stav „čeká na přenos“ však musí být viditelný. Definujte maximální přijatelné zpoždění a upozornění na jeho překročení. Zelená dostupnost webu nic neříká o hodinách neodeslaných objednávek.

  • Omezte souběžnost podle skutečných limitů poskytovatele.
  • Při opakování použijte rostoucí prodlevu s náhodným rozptylem.
  • Respektujte serverem doporučené čekání, pokud je poskytuje.
  • Trvalé chyby přesuňte k ručnímu řešení s konkrétním důvodem.

Ne každou chybu lze zkusit znovu

Neplatné údaje nebo chybějící oprávnění obvykle neopraví deset opakování. U zápisových operací navíc může vzniknout nejistota, zda protistrana požadavek provedla před výpadkem odpovědi. Použijte podporovaný idempotentní identifikátor nebo dohledání výsledku podle obchodního klíče.

Po obnovení služby neposílejte celou nahromaděnou frontu naráz. Tím byste okamžitě vyvolali další omezení. Pro urgentní operace nastavte dohodnutou prioritu, ale hlídejte, aby běžná práce nezůstala ve frontě navždy.

Kontrolujte stáří, ne jen velikost fronty

Deset položek čekajících dva dny může být závažnější problém než tisíc čerstvých změn ceníku. Sledujte nejstarší úkol, dobu zpracování a podíl opakování. Při testu úmyslně vyvolejte omezení a ověřte, že se integrace sama řízeně vrátí do běžného režimu.

Naráží vaše integrace na limity API?

Navrhneme řízení přenosu, viditelné stavy a bezpečné opakování nedokončené práce.

Probrat spolehlivou integraci

Související čtení

Řešíte podobný projekt?

Pojďme ho nezávazně probrat. Ukážeme vám související služby i zkušenosti z realizovaných projektů.

Prohlédnout služby Naše realizace Nezávazně konzultovat