Chybové stavy

Tato stránka popisuje nejdůležitější HTTP statusy a chybové kódy.

Struktura chybové odpovědi

Všechny chybové odpovědi mají jednotný formát:

{
  "Code": "INVALID_API_KEY",
  "Message": "Popis chyby"
}

U chyby 429 je navíc pole RetryAfterSeconds:

{
  "Code": "RATE_LIMIT_EXCEEDED",
  "Message": "Too many requests. Please try again later.",
  "RetryAfterSeconds": 10
}

Přehled chybových stavů

400 Bad Request

Kód	Popis
MISSING_API_KEY	Hlavička X-Api-Key chybí

401 Unauthorized

Kód	Popis
INVALID_API_KEY	Klíč neexistuje nebo je neplatný
SECRET_REQUIRED	Chybí tajná část klíče (očekává se KeyId.Secret)
INVALID_SECRET	Tajná část klíče je neplatná
COMPANY_API_DISABLED	API přístup je pro vaši společnost deaktivovaný
API_KEY_DISABLED	Konkrétní klíč je deaktivovaný

403 Forbidden

Kód	Popis
IP_NOT_AUTHORIZED	Přístup zablokovaný z důvodu IP autorizace

409 Conflict

Kód	Popis
EXPORT_DUPLICATE	Duplicitní export – požadavek se stejnými parametry už existuje

429 Too Many Requests

Kód	Popis
RATE_LIMIT_EXCEEDED	Překročen rate limit – viz Limity volání

5xx Server Error

Chyba na straně serveru. Zkuste požadavek opakovat později.
Pokud problém přetrvává, kontaktuje nás na enterprise@xdent.cz

Logování pro diagnostiku

Při řešení chyb vždy ukládejte:

• HTTP status a kód chyby (Code),
• X-Request-Id z response hlavičky,
• Endpoint a čas volání.