Chyby

Většina veřejných handlerů používá následující standardní JSON obálku:

{
  "status_code": 409,
  "error_type": "conflict",
  "message": "Attribute was modified; refetch it before retrying",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "code": "stale_write",
  "retryable": false,
  "current_updated_at": "2026-08-30T12:45:00.000Z"
}

Standardní odpověď může obsahovat také code, retryable, details, current_updated_at, attribute_id nebo attribute_key. Pokud je code přítomný, používejte ho jako stabilní detailní identifikátor.

Těla konkrétních endpointů

Některé handlery standardní helper nepoužívají. Nepředpokládejte proto, že každá neúspěšná odpověď obsahuje všechna čtyři standardní pole.

Validace Katalogu může vrátit { "error_type": "validation_error", "errors": [...] }.
Zastaralý zápis do Katalogu může vrátit { "code": "stale_write", "current_updated_at": "..." }.
Blokovaný export a konflikt závislostí schématu používají pole popsaná u daného endpointu.
Search a Enrich mohou nedostatek kreditů oznámit uvnitř HTTP 200. Enhancement vrátí 202 ještě před kontrolou zůstatku; výslednou chybu sledujte ve stavu enhancementu.

Uchovejte HTTP stav i celé původní tělo odpovědi.

Typ chyby	Obvyklý stav	Význam
`invalid_request`	`400`	Chybný požadavek, parametr nebo metoda.
`unauthenticated`	`401`	Chybějící, neplatný nebo deaktivovaný API klíč.
`forbidden`	`403`	Aktér nemůže akci provést.
`not_found`	`404`	Zdroj ve společnosti klíče neexistuje.
`conflict`	`409`	Požadavek je v konfliktu se stavem nebo závislostmi.
`validation_error`	`422`	Neplatné pole nebo hodnota.
`rate_limited`	`429`	Překročený limit nebo cooldown.
`service_unavailable`	`503`	Potřebná závislost není dostupná. Zkontrolujte `retryable`.
`internal_error`	`500`	Server požadavek nedokončil.

Přehled

Vyhledávání

Obohacení dat

Tabulky

Řádky

Obohacení

Schémata

Atributy

Soubory

Slovník

Kredity

Produktová analytika

Katalog

Webhooky katalogu

Těla konkrétních endpointů

​Těla konkrétních endpointů

Těla konkrétních endpointů