Veřejné API

Diagnostika 401, 403, 422 a 429

401 znamená, že klíč nebyl vůbec přijat. 403 znamená, že přijat byl, ale operace není povolena. 422 znamená, že požadavek byl pochopen a payload byl špatně. 429 znamená, že jste přes rate limit a máte počkat, ne opakovat hned.

Ověřeno 20. srpna 2026

Kroky

1. U 401 ověřte, že klíč existuje, nevypršel a odesílá se v hlavičce, o které si myslíte — obvyklou příčinou je useknuté vložení.
2. U 403 přečtěte code: nedostatečný scope, adresa mimo allow-list, nebo klíč jiného workspace. Nové připojení nepomůže; musí se změnit oprávnění.
3. U 422 přečtěte pole, které odpověď jmenuje, a opravte payload.
4. U 429 respektujte hlavičky rate limitu a počkejte. Okamžité opakování to jen zhorší.
5. Uschovejte requestId z odpovědi — právě to umožní podpoře najít vaše konkrétní volání.

Jak ověřit výsledek

Tentýž požadavek po opravě projde a odpověď nese status 2xx s očekávaným objektem.

Co se obvykle pokazí

• Brát 403 jako špatný klíč a vydat ho znovu, což nic nezmění.
• Opakovat 429 v těsné smyčce.
• Poslat podpoře klíč místo ID požadavku.