Katalog chybových kódů
Každá položka uvádí známý kód, HTTP stav při odmítnutí, nápravu a pravidlo opakování. Kód vyhledejte vyhledáváním v záhlaví. Stejný seznam je ve stažitelném OpenAPI v x-error-catalog.
Rozsah odlišuje veřejné požadavky od správy přístupů v přihlášené aplikaci a následného zpracování. Sdílené doménové kontroly platí podle konkrétní operace, stavu a oprávnění; seznam nezpřístupňuje nové endpointy. U následného zpracování uvedený stav odpovídá bráně při přijetí, pokud je stejná kontrola prováděna synchronně; přijatá zpráva má svůj výsledek, nikoli dodatečnou HTTP chybu původního požadavku.
202 potvrzuje přijetí, nikoli doručení. Sledujte stav, důvod, pokusy a události zprávy. Nedoručení, stížnost, blokace, expirace a nejisté předání poskytovateli vyžadují různé postupy uvedené v řešení problémů. Cesta mimo zveřejněný základ API v1 může vrátit obecnou odpověď 404 mimo tento formát. Proxy, přerušené spojení nebo nedostupný server mohou vrátit neúplnou odpověď či jiný formát; klient musí zvládnout i chybu bez code. Rozšiřitelné pole code není uzavřený enum: neznámý kód zpracujte podle HTTP stavu, uchovejte request_id a při nejasném výsledku neposílejte zprávu znovu s novou identitou.
address_registry_blocked
Veřejné API · HTTP 409
Situace: Účinná ochrana příjemce blokuje odeslání.
Řešení: Ověřte důvod ve výsledku zprávy a kontrole blokací. Trvalé nedoručení, stížnost ani zákaz neobcházejte novým kontaktem či klíčem.
Opakování: Blokovanému příjemci automaticky neposílejte znovu.
admin_reauthentication_required
Správa API přístupu v aplikaci · HTTP 403
Situace: Pro změnu kapacity se znovu přihlaste.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
allowed_ips_conflict
Správa API přístupu v aplikaci · HTTP 409
Situace: Povolené adresy mezitím někdo změnil. Obnovte integraci a změnu zopakujte.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
api_admission_revoked
Veřejné API · HTTP 403
Situace: Aktuální role, členství nebo stav přístupu operaci nepovolují.
Řešení: Vlastník zkontroluje roli zakladatele, ověření e-mailu, členství a stav organizace, projektu i integrace. Nový klíč stejné integrace nemusí pomoci.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
api_key_expired
Veřejné API · HTTP 401
Situace: Chybí platný strojový přístup, klíč byl zrušený nebo mu skončila platnost.
Řešení: Ověřte Authorization: Bearer, správnou integraci a platnost klíče. Vlastník nebo administrátor jej nahradí; klíč neposílejte v URL ani podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
api_plan_required
Veřejné API · HTTP 403
Situace: Tarif organizace nemá funkci API a integrace.
Řešení: Vlastník organizace přejde na tarif, který API obsahuje (v aplikaci Nastavení organizace → Tarif a fakturace). Klíč zůstává platný a po změně tarifu začne fungovat bez výměny.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
audience_member_ineligible_at_snapshot
Veřejné API · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
audience_snapshot_unavailable
Veřejné API · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_block_idempotency_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_block_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_block_limit_reached
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_block_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_block_name_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_block_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_block_version_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_dry_run_capability_required
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_already_active
Sdílená doménová kontrola · HTTP 409
Situace: Automatizace už má aktivní sledování.
Řešení: Načtěte současné sledování a použijte jeho ID. Nový start není potřebný; změnu nebo ukončení proveďte podporovanou akcí nad aktuální revizí.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_baseline_timeout
Sdílená doménová kontrola · HTTP 503
Situace: Potřebný runtime, klíč nebo výpočet není nyní dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
automation_observation_baseline_too_large
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_capability_required
Sdílená doménová kontrola · HTTP 503
Situace: Potřebná služba nebo podklad nejsou nyní dostupné.
Řešení: Respektujte Retry-After a načtěte aktuální stav původního požadavku. Při trvajícím selhání předejte code a request_id podpoře; znovu založený objekt ani klíč výpadek služby neřeší.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
automation_observation_history_limit
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_idempotency_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_lifecycle_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Potřebná služba nebo podklad nejsou nyní dostupné.
Řešení: Respektujte Retry-After a načtěte aktuální stav původního požadavku. Při trvajícím selhání předejte code a request_id podpoře; znovu založený objekt ani klíč výpadek služby neřeší.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
automation_observation_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_revision_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_observation_runtime_disabled
Sdílená doménová kontrola · HTTP 503
Situace: Potřebný runtime, klíč nebo výpočet není nyní dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
automation_observation_worker_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Potřebný runtime, klíč nebo výpočet není nyní dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
automation_observation_workspace_limit
Sdílená doménová kontrola · HTTP 409
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
automation_workflow_graph_simulation_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_graph_v3_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_idempotency_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_name_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_no_change
Sdílená doménová kontrola · HTTP 409
Situace: Navržené uložení se neliší od aktuálního obsahu.
Řešení: Použijte současnou revizi. Pokud jste změnu zamýšleli, porovnejte načtený koncept a odesílaná pole; nový požadavek vytvořte až pro skutečně změněný obsah.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_observation_active
Sdílená doménová kontrola · HTTP 409
Situace: Aktuální stav objektu nesplňuje předpoklady operace.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_simulation_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
automation_workflow_version_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_ab_variant_ledger_contract_mismatch
Sdílená doménová kontrola · HTTP 409
Situace: Podklady A/B variant neodpovídají evidenci zpráv.
Řešení: Zastavte přípravu a předejte ID kampaně a request_id podpoře. Provozovatel musí ověřit integritu variant a evidence; nekopírujte kampaň za účelem vynucení odeslání.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_active_snapshot_limit
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_approval_already_decided
Sdílená doménová kontrola · HTTP 409
Situace: Schvalovací pravidla nebo podmínky přípravy kampaně nejsou splněné.
Řešení: Načtěte readiness a historii schválení. Ověřte režim, oprávněného schvalovatele a aktuální neměnné podklady. Změněný obsah potřebuje nové potvrzení; přísný režim nelze obejít běžným dokončením přípravy.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_approval_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Schvalovací pravidla nebo podmínky přípravy kampaně nejsou splněné.
Řešení: Načtěte readiness a historii schválení. Ověřte režim, oprávněného schvalovatele a aktuální neměnné podklady. Změněný obsah potřebuje nové potvrzení; přísný režim nelze obejít běžným dokončením přípravy.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_approval_governance_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Schvalovací pravidla nebo podmínky přípravy kampaně nejsou splněné.
Řešení: Načtěte readiness a historii schválení. Ověřte režim, oprávněného schvalovatele a aktuální neměnné podklady. Změněný obsah potřebuje nové potvrzení; přísný režim nelze obejít běžným dokončením přípravy.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_approval_prerequisite_not_ready
Sdílená doménová kontrola · HTTP 409
Situace: Schvalovací pravidla nebo podmínky přípravy kampaně nejsou splněné.
Řešení: Načtěte readiness a historii schválení. Ověřte režim, oprávněného schvalovatele a aktuální neměnné podklady. Změněný obsah potřebuje nové potvrzení; přísný režim nelze obejít běžným dokončením přípravy.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_approval_request_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Schvalovací pravidla nebo podmínky přípravy kampaně nejsou splněné.
Řešení: Načtěte readiness a historii schválení. Ověřte režim, oprávněného schvalovatele a aktuální neměnné podklady. Změněný obsah potřebuje nové potvrzení; přísný režim nelze obejít běžným dokončením přípravy.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_approval_required
Veřejné API · HTTP 409
Situace: Schvalovací pravidla nebo podmínky přípravy kampaně nejsou splněné.
Řešení: Načtěte readiness a historii schválení. Ověřte režim, oprávněného schvalovatele a aktuální neměnné podklady. Změněný obsah potřebuje nové potvrzení; přísný režim nelze obejít běžným dokončením přípravy.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_approval_self_decision_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Schvalovací pravidla nebo podmínky přípravy kampaně nejsou splněné.
Řešení: Načtěte readiness a historii schválení. Ověřte režim, oprávněného schvalovatele a aktuální neměnné podklady. Změněný obsah potřebuje nové potvrzení; přísný režim nelze obejít běžným dokončením přípravy.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_archive_blocked
Sdílená doménová kontrola · HTTP 409
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_archive_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_archive_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_archive_revision_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_definition_unsupported
Sdílená doménová kontrola · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_list_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_refresh_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_refresh_dispatch_active
Sdílená doménová kontrola · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_refresh_in_progress
Sdílená doménová kontrola · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_refresh_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_segment_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_audience_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_bulk_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_bulk_selection_changed
Sdílená doménová kontrola · HTTP 409
Situace: Aktuální stav objektu nesplňuje předpoklady operace.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_bulk_selection_size_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_catalog_filter_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_content_capability_required
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_content_draft_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_content_draft_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_content_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_content_media_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Zdrojový obsah, šablona nebo používaný obrázek nejsou dostupné.
Řešení: Načtěte zdroj ve stejném projektu, ověřte jeho aktuální stav a dostupnost všech použitých souborů. Zvolte existující podporovaný zdroj, znovu vytvořte náhled a potvrďte aktualizované podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_content_review_quality_required
Sdílená doménová kontrola · HTTP 409
Situace: Potvrzení se nevztahuje k aktuálním podkladům kampaně.
Řešení: Znovu načtěte readiness a delivery-readiness. Použijte aktuální reviewPackage.id a expectedSourceInputHash o 64 malých hexadecimálních znacích; v běžném režimu dokončete přípravu, v přísném nové schválení.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_content_review_version_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_delete_blocked
Sdílená doménová kontrola · HTTP 409
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_delivery_plan_already_decided
Sdílená doménová kontrola · HTTP 409
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_delivery_plan_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_delivery_plan_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_delivery_plan_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_delivery_plan_prerequisite_not_ready
Sdílená doménová kontrola · HTTP 409
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_delivery_plan_self_decision_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_delivery_plan_timing_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Navržený čas nebo rozložení odesílání nejsou přípustné.
Řešení: Zkontrolujte budoucí termín, časové pásmo a odmítnutí neexistujícího či nejednoznačného místního času. Stejný schedule_out_of_range může mít při zařazení 409 a při přeplánování 422.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_delivery_plan_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Aktuální provozní nebo tarifní brána odeslání nepovoluje.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_dispatch_approval_not_current
Veřejné API · HTTP 409
Situace: Potvrzení se nevztahuje k aktuálním podkladům kampaně.
Řešení: Znovu načtěte readiness a delivery-readiness. Použijte aktuální reviewPackage.id a expectedSourceInputHash o 64 malých hexadecimálních znacích; v běžném režimu dokončete přípravu, v přísném nové schválení.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_audience_empty
Veřejné API · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_audience_invalid
Veřejné API · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_audience_not_ready
Veřejné API · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_campaign_not_found
Veřejné API · HTTP 404
Situace: Současné podmínky neumožňují zařazení kampaně.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_campaign_paused
Veřejné API · HTTP 409
Situace: Kampaň byla pozastavena operátorem.
Řešení: Načtěte aktuální stav kampaně a obnovte rozesílku v jejím detailu; nový požadavek pauzu neobchází.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_campaign_stopped
Veřejné API · HTTP 409
Situace: Zbývající rozesílka byla nevratně ukončena.
Řešení: Neopakujte požadavek jako pokus o obnovení; pro novou rozesílku vytvořte samostatnou kampaň.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_confirmation_required
Veřejné API · HTTP 409
Situace: Potvrzení se nevztahuje k aktuálním podkladům kampaně.
Řešení: Znovu načtěte readiness a delivery-readiness. Použijte aktuální reviewPackage.id a expectedSourceInputHash o 64 malých hexadecimálních znacích; v běžném režimu dokončete přípravu, v přísném nové schválení.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_delivery_plan_unavailable
Veřejné API · HTTP 409
Situace: Doručovací plán kampaně nejde nyní připravit. Důvody jsou ve fields.blocked_by.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_dispatch_idempotency_conflict
Veřejné API · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_not_cancellable
Veřejné API · HTTP 409
Situace: Příprava nebo předání už začaly, případně je požadavek ukončený.
Řešení: Načtěte aktuální stav a povolené akce. Zrušení či přeplánování nelze vynutit nad rozpracovaným nebo již předaným požadavkem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_not_found
Veřejné API · HTTP 404
Situace: Požadavek nyní nelze přeplánovat. Ověřte současný stav a přípustný termín.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_not_reschedulable
Veřejné API · HTTP 409
Situace: Příprava nebo předání už začaly, případně je požadavek ukončený.
Řešení: Načtěte aktuální stav a povolené akce. Zrušení či přeplánování nelze vynutit nad rozpracovaným nebo již předaným požadavkem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_schedule_local_time_invalid
Veřejné API · HTTP 422
Situace: Navržený čas nebo rozložení odesílání nejsou přípustné.
Řešení: Zkontrolujte budoucí termín, časové pásmo a odmítnutí neexistujícího či nejednoznačného místního času. Stejný schedule_out_of_range může mít při zařazení 409 a při přeplánování 422.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_schedule_out_of_range
Veřejné API · HTTP 409, 422
Situace: Navržený čas nebo rozložení odesílání nejsou přípustné.
Řešení: Zkontrolujte budoucí termín, časové pásmo a odmítnutí neexistujícího či nejednoznačného místního času. Stejný schedule_out_of_range může mít při zařazení 409 a při přeplánování 422.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dispatch_source_changed
Sdílená doménová kontrola · HTTP 409
Situace: Potvrzení se nevztahuje k aktuálním podkladům kampaně.
Řešení: Znovu načtěte readiness a delivery-readiness. Použijte aktuální reviewPackage.id a expectedSourceInputHash o 64 malých hexadecimálních znacích; v běžném režimu dokončete přípravu, v přísném nové schválení.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_dry_run_capability_required
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_subject_link_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_draft_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_idempotency_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_limit_reached
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_name_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_no_change
Sdílená doménová kontrola · HTTP 409
Situace: Navržené uložení se neliší od aktuálního obsahu.
Řešení: Použijte současnou revizi. Pokud jste změnu zamýšleli, porovnejte načtený koncept a odesílaná pole; nový požadavek vytvořte až pro skutečně změněný obsah.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_preview_unavailable
Sdílená doménová kontrola · HTTP 422
Situace: Náhled se nepodařilo sestavit. Zkontrolujte obsah a délky vstupních polí.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_published_delete
Sdílená doménová kontrola · HTTP 409
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_restore_source_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_email_template_version_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_governance_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_governance_permission_required
Sdílená doménová kontrola · HTTP 409
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_governance_support_context_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_governance_validation_error
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_governance_version_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_idempotency_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_name_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_rename_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_rename_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_results_link_not_found
Správa API přístupu v aplikaci · HTTP 404
Situace: Tento odkaz kampaň neměřila. Obnovte stránku a vyberte odkaz znovu.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_results_list_unmeasured
Sdílená doménová kontrola · HTTP 409, 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_rename_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_review_package_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Potvrzení se nevztahuje k aktuálním podkladům kampaně.
Řešení: Znovu načtěte readiness a delivery-readiness. Použijte aktuální reviewPackage.id a expectedSourceInputHash o 64 malých hexadecimálních znacích; v běžném režimu dokončete přípravu, v přísném nové schválení.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_review_package_prerequisite_not_ready
Sdílená doménová kontrola · HTTP 409
Situace: Potvrzení se nevztahuje k aktuálním podkladům kampaně.
Řešení: Znovu načtěte readiness a delivery-readiness. Použijte aktuální reviewPackage.id a expectedSourceInputHash o 64 malých hexadecimálních znacích; v běžném režimu dokončete přípravu, v přísném nové schválení.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_idempotency_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_limit_reached
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_link_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_name_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_no_change
Sdílená doménová kontrola · HTTP 409
Situace: Navržené uložení se neliší od aktuálního obsahu.
Řešení: Použijte současnou revizi. Pokud jste změnu zamýšleli, porovnejte načtený koncept a odesílaná pole; nový požadavek vytvořte až pro skutečně změněný obsah.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_saved_section_version_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_sender_profile_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Odesílatel, ověřená doména nebo odesílací cesta nejsou připravené.
Řešení: Zkontrolujte sender_profile_id, projekt, připravenost odesílatele, DNS a stav odesílací cesty. Chybné či změněné nastavení řeší vlastník nebo podpora; připravenost neobcházejte.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_sender_selection_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Odesílatel, ověřená doména nebo odesílací cesta nejsou připravené.
Řešení: Zkontrolujte sender_profile_id, projekt, připravenost odesílatele, DNS a stav odesílací cesty. Chybné či změněné nastavení řeší vlastník nebo podpora; připravenost neobcházejte.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
campaign_sender_selection_support_context_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_source_campaign_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Zdrojový obsah, šablona nebo používaný obrázek nejsou dostupné.
Řešení: Načtěte zdroj ve stejném projektu, ověřte jeho aktuální stav a dostupnost všech použitých souborů. Zvolte existující podporovaný zdroj, znovu vytvořte náhled a potvrďte aktualizované podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_source_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_source_template_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Zdrojový obsah, šablona nebo používaný obrázek nejsou dostupné.
Řešení: Načtěte zdroj ve stejném projektu, ověřte jeho aktuální stav a dostupnost všech použitých souborů. Zvolte existující podporovaný zdroj, znovu vytvořte náhled a potvrďte aktualizované podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_standard_preparation_mode_required
Sdílená doménová kontrola · HTTP 409
Situace: Kampaň vyžaduje přísný režim schválení.
Řešení: Dokončení běžné přípravy nenahrazuje schválení oprávněnou druhou osobou. Načtěte readiness a review-history a projděte požadovaný schvalovací postup.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_standard_preparation_support_context_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_tag_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_tag_mutation_forbidden
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_tag_parent_not_found
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_tag_revision_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_direct_access_required
Sdílená doménová kontrola · HTTP 409
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_ledger_direct_access_required
Sdílená doménová kontrola · HTTP 409
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_quota_exceeded
Sdílená doménová kontrola · HTTP 409
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_reservation_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_reservation_idempotency_conflict
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_reservation_not_executable
Sdílená doménová kontrola · HTTP 409
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_reservation_unavailable
Sdílená doménová kontrola · HTTP 503
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
campaign_test_email_support_recipient_invalid
Sdílená doménová kontrola · HTTP 422
Situace: Ruční test kampaně nemá použitelnou rezervaci nebo přímý oprávněný přístup.
Řešení: Ruční test otevřete ve vlastním přihlášeném účtu s právem spravovat kampaň a načtěte stav původní rezervace. Support ani veřejný klíč nepoužívejte jako náhradu přímého potvrzení; při nejistém výsledku nezakládejte další test.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte vstupní pole transakční šablony.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
capacity_version_conflict
Správa API přístupu v aplikaci · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Potvrďte adresy a oprávněné zpracování kontaktů.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 409, 422
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: POST /contacts/bulk dostal víc než 1 000 kontaktů. Nic nebylo přijato.
Řešení: Rozdělte kontakty do více požadavků po nejvýše 1 000, každý s vlastním Idempotency-Key. Postup pro desítky a stovky tisíc kontaktů popisuje kapitola Hromadné nahrání kontaktů.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Sdílená doménová kontrola · HTTP 422
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 404
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 404
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Publikum kampaně nebo jeho podklad nejsou použitelné.
Řešení: Načtěte readiness a aktuální publikum. Vyčkejte dopočtu, opravte skupinu či segment a ověřte skutečně oprávněné příjemce. Při aktivním dispatch neměňte jeho podklady.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Chybí výslovné potvrzení oprávnění přihlásit kontakty k odběru.
Řešení: Před potvrzením hromadného přihlášení ověřte souhlas kontaktů a odešlete consentConfirmed: true. Bez doloženého souhlasu operaci nepotvrzujte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Podklady, oprávnění nebo identita hromadné operace se změnily.
Řešení: Načtěte stav původní operace a aktuální náhled se stejným výběrem kontaktů. Ověřte oprávnění a dostupnost cílového odběru. Jiný rozsah či obsah musí mít novou identitu až po vyjasnění původního výsledku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Podklady, oprávnění nebo identita hromadné operace se změnily.
Řešení: Načtěte stav původní operace a aktuální náhled se stejným výběrem kontaktů. Ověřte oprávnění a dostupnost cílového odběru. Jiný rozsah či obsah musí mít novou identitu až po vyjasnění původního výsledku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Podklady, oprávnění nebo identita hromadné operace se změnily.
Řešení: Načtěte stav původní operace a aktuální náhled se stejným výběrem kontaktů. Ověřte oprávnění a dostupnost cílového odběru. Jiný rozsah či obsah musí mít novou identitu až po vyjasnění původního výsledku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Podklady, oprávnění nebo identita hromadné operace se změnily.
Řešení: Načtěte stav původní operace a aktuální náhled se stejným výběrem kontaktů. Ověřte oprávnění a dostupnost cílového odběru. Jiný rozsah či obsah musí mít novou identitu až po vyjasnění původního výsledku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Podklady, oprávnění nebo identita hromadné operace se změnily.
Řešení: Načtěte stav původní operace a aktuální náhled se stejným výběrem kontaktů. Ověřte oprávnění a dostupnost cílového odběru. Jiný rozsah či obsah musí mít novou identitu až po vyjasnění původního výsledku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Podklady, oprávnění nebo identita hromadné operace se změnily.
Řešení: Načtěte stav původní operace a aktuální náhled se stejným výběrem kontaktů. Ověřte oprávnění a dostupnost cílového odběru. Jiný rozsah či obsah musí mít novou identitu až po vyjasnění původního výsledku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 503
Situace: Podklady, oprávnění nebo identita hromadné operace se změnily.
Řešení: Načtěte stav původní operace a aktuální náhled se stejným výběrem kontaktů. Ověřte oprávnění a dostupnost cílového odběru. Jiný rozsah či obsah musí mít novou identitu až po vyjasnění původního výsledku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 409
Situace: Kontaktní kanál není platný, byl vyřazený nebo kontakt není dostupný.
Řešení: Načtěte aktuální kontakt a jeho kanály ve vlastním projektu. Vyřazenou či rizikovou adresu nepoužívejte pro nové odesílání; případnou změnu proveďte podporovanou úpravou kontaktu s oprávněním a doloženým původem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 409
Situace: Kontaktní kanál není platný, byl vyřazený nebo kontakt není dostupný.
Řešení: Načtěte aktuální kontakt a jeho kanály ve vlastním projektu. Vyřazenou či rizikovou adresu nepoužívejte pro nové odesílání; případnou změnu proveďte podporovanou úpravou kontaktu s oprávněním a doloženým původem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 503
Situace: Potřebný runtime, klíč nebo výpočet není nyní dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Správa API přístupu v aplikaci · HTTP 403
Situace: Podpora může exportovat jen okamžitě, nejvýše 5 000 kontaktů.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 404
Situace: Export v tomto projektu není.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 409
Situace: Soubor exportu není k dispozici. Mohl vypršet, selhat nebo se ještě připravuje.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 409, 429
Situace: V projektu se už připravují tři exporty. Počkejte, až některý doběhne.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 409, 503
Situace: Nejdřív si ověřte e-mailovou adresu účtu.
Řešení: Respektujte Retry-After a načtěte aktuální stav původního požadavku. Při trvajícím selhání předejte code a request_id podpoře; znovu založený objekt ani klíč výpadek služby neřeší.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Pole používá segment, formulář nebo automatizace. Nejprve vyřešte vazby.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Vlastní pole nebo podklad segmentu neodpovídají aktuálním datům.
Řešení: Znovu načtěte katalog polí, typ a aktuální stav kontaktu či segmentu. Opravte konkrétní field a jeho hodnotu; při nedostupném dopočtu vyčkejte a znovu vytvořte náhled před zápisem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 422
Situace: Filtr podle pole už neplatí. Vyberte jiné pole nebo upravte hodnotu.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Neznámé vlastní pole. Nejprve je založte v projektu.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 503
Situace: Import je nyní nedostupný.
Řešení: Respektujte Retry-After a načtěte aktuální stav původního požadavku. Při trvajícím selhání předejte code a request_id podpoře; znovu založený objekt ani klíč výpadek služby neřeší.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Import nemá použitelný aktuální náhled, mapování nebo doložený původ dat.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Import nemá použitelný aktuální náhled, mapování nebo doložený původ dat.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Import nemá použitelný aktuální náhled, mapování nebo doložený původ dat.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 404
Situace: Import nebyl nalezen v povoleném projektu.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte aktuální náhled a vstupy importu.
Řešení: Zkontrolujte fields a konkrétní konec kódu: preview_mismatch znamená jiný otisk souboru; expired_or_missing vyžaduje nový náhled; mapping a recount opakovanou kontrolu; source_too_large menší soubor; attestation doložení pravosti a oprávnění. Nepřihlašujte kontakty k odběru bez podkladu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 503
Situace: Import je nyní nedostupný.
Řešení: Respektujte Retry-After a načtěte aktuální stav původního požadavku. Při trvajícím selhání předejte code a request_id podpoře; znovu založený objekt ani klíč výpadek služby neřeší.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zkontrolujte výběr skupiny importu.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 404
Situace: Zkontrolujte výběr skupiny importu.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Kontakt obsahuje neplatná data.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 409
Situace: Aktuální stav objektu nesplňuje předpoklady operace.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 409
Situace: Aktuální stav objektu nesplňuje předpoklady operace.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Byla dosažena kapacita operace nebo objektů.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Odkaz na preference je neplatný, vypršel nebo jeho cíl není dostupný.
Řešení: Příjemce potřebuje aktuální odkaz pro správný kontakt a odběr. Token neupravujte ani nepřenášejte mezi adresami. Oprávněný správce ověří stav odběru; starý odkaz neobnovujte slepým opakováním.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 503
Situace: Odkaz na preference je neplatný, vypršel nebo jeho cíl není dostupný.
Řešení: Příjemce potřebuje aktuální odkaz pro správný kontakt a odběr. Token neupravujte ani nepřenášejte mezi adresami. Oprávněný správce ověří stav odběru; starý odkaz neobnovujte slepým opakováním.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 503
Situace: Potřebný runtime, klíč nebo výpočet není nyní dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Sdílená doménová kontrola · HTTP 409
Situace: Odkaz na preference je neplatný, vypršel nebo jeho cíl není dostupný.
Řešení: Příjemce potřebuje aktuální odkaz pro správný kontakt a odběr. Token neupravujte ani nepřenášejte mezi adresami. Oprávněný správce ověří stav odběru; starý odkaz neobnovujte slepým opakováním.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Odkaz na preference je neplatný, vypršel nebo jeho cíl není dostupný.
Řešení: Příjemce potřebuje aktuální odkaz pro správný kontakt a odběr. Token neupravujte ani nepřenášejte mezi adresami. Oprávněný správce ověří stav odběru; starý odkaz neobnovujte slepým opakováním.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Vlastní pole nebo podklad segmentu neodpovídají aktuálním datům.
Řešení: Znovu načtěte katalog polí, typ a aktuální stav kontaktu či segmentu. Opravte konkrétní field a jeho hodnotu; při nedostupném dopočtu vyčkejte a znovu vytvořte náhled před zápisem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 503
Situace: Vlastní pole nebo podklad segmentu neodpovídají aktuálním datům.
Řešení: Znovu načtěte katalog polí, typ a aktuální stav kontaktu či segmentu. Opravte konkrétní field a jeho hodnotu; při nedostupném dopočtu vyčkejte a znovu vytvořte náhled před zápisem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Správa API přístupu v aplikaci · HTTP 422
Situace: Vybraný odkaz kampaň neměří. Vyberte jiný odkaz nebo podmínku upravte.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 503
Situace: Potřebný runtime, klíč nebo výpočet není nyní dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 503
Situace: Potřebný runtime, klíč nebo výpočet není nyní dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 403
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Akce není povolená nad aktuálním výchozím typem odběru.
Řešení: Načtěte katalog odběrů a respektujte výchozí nebo systémový typ. Případnou změnu výchozího typu proveďte podporovanou správou; jeho vazby nemažte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 403
Situace: Současné oprávnění nebo ochranná pravidla operaci nepovolují.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 409
Situace: Kontaktní kanál není platný, byl vyřazený nebo kontakt není dostupný.
Řešení: Načtěte aktuální kontakt a jeho kanály ve vlastním projektu. Vyřazenou či rizikovou adresu nepoužívejte pro nové odesílání; případnou změnu proveďte podporovanou úpravou kontaktu s oprávněním a doloženým původem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 403
Situace: Aktuální role, členství nebo stav přístupu operaci nepovolují.
Řešení: Vlastník zkontroluje roli zakladatele, ověření e-mailu, členství a stav organizace, projektu i integrace. Nový klíč stejné integrace nemusí pomoci.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
domain_not_verified
Veřejné API · HTTP 409
Situace: Vlastnictví odesílací domény není ověřené.
Řešení: V nastavení domény doplňte požadované DNS záznamy a vyčkejte ověření. Zkontrolujte také SES identitu, odesílatele a skutečnou připravenost; samotné založení domény nestačí.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
enrollment_unavailable
Veřejné API · HTTP 409
Situace: Tarif organizace není aktivní, proto odesílání není povolené.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
event_cursor_expired
Veřejné API · HTTP 410
Situace: Vypršela dostupnost detailu nebo kurzoru událostí.
Řešení: Začněte nové čtení událostí a dorovnejte jej podle vlastní evidence a zachovaných výsledků. Po odstranění dat může následovat 404; lhůty detailu a idempotence jsou různé.
Opakování: Expirace historie není důkaz neodeslání. Automaticky neposílejte náhradní e-mail.
event_ingest_not_ready
Veřejné API · HTTP 409
Situace: Příjem událostí SES není provozně připravený.
Řešení: Příjem zpráv přes API na tento stav nečeká, zpráva čeká ve frontě. Kód vrací ruční test v aplikaci. Provozovatel ověří příjem událostí, jejich přiřazení a stav zpracovatele. Bez spolehlivých výsledků nezvyšujte objem ani neobcházejte odesílací bránu.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
global_dispatch_disabled
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
idempotency_conflict
Veřejné API · HTTP 409
Situace: Stejný klíč nebo identita operace označují jiný vstup.
Řešení: Dohledejte původní výsledek. Pro opakování vraťte přesně původní metodu, cestu a tělo; změněný záměr oddělte novým klíčem až po vyjasnění původního.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
idempotency_key_invalid
Veřejné API · HTTP 422
Situace: Idempotency-Key obsahuje nepovolený znak (například mezeru nebo diakritiku) nebo má nepovolenou délku.
Řešení: Vygenerujte klíč jen z písmen bez diakritiky, číslic a znaků _ . : - o délce 8–128, například UUID. Požadavek nebyl přijat, nic nevzniklo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
idempotency_key_required
Veřejné API · HTTP 422
Situace: Chybí správný klíč bezpečného opakování.
Řešení: Přidejte Idempotency-Key o 8–128 znacích: písmena, číslice, podtržítko, tečka, dvojtečka a pomlčka. Jeden klíč označuje jednu nezměněnou operaci.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
idempotency_result_expired
Veřejné API · HTTP 409, 410
Situace: Známá operace už nemá dostupný výsledek; ochranný otisk ještě brání nové práci.
Řešení: Dohledejte ID zprávy nebo dávky, vlastní evidenci a případně podporu. HTTP 409 patří opakování zápisu, 410 může patřit dohledání výsledku ručního testu.
Opakování: Zastavte automatické opakování. Nevytvářejte nový klíč jen kvůli expiraci výsledku.
integration_manager_required
Správa API přístupu v aplikaci · HTTP 403
Situace: Aktuální role, členství nebo stav přístupu operaci nepovolují.
Řešení: Vlastník zkontroluje roli zakladatele, ověření e-mailu, členství a stav organizace, projektu i integrace. Nový klíč stejné integrace nemusí pomoci.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
integration_not_active
Veřejné API · HTTP 409
Situace: Integrace je zrušená nebo není aktivní.
Řešení: Ověřte životní cyklus integrace. Zrušenou integraci nelze obnovit. Čekající a již předané zprávy posuzujte samostatně; nový klíč starou práci neodvolá.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
integration_not_found
Správa API přístupu v aplikaci · HTTP 404
Situace: Integrace nebyla nalezena.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
integration_paused
Veřejné API · HTTP 409, 503
Situace: Integrace, projekt nebo požadavek jsou pozastavené.
Řešení: Zjistěte rozsah pauzy. Pauza integrace odmítá nové zápisy; pauza transakčního projektu může dál přijímat do fronty. Obnovení musí provést oprávněný správce. Platnost fronty dál běží.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
integration_permission_revoked
Veřejné API · HTTP 403
Situace: Aktuální role, členství nebo stav přístupu operaci nepovolují.
Řešení: Vlastník zkontroluje roli zakladatele, ověření e-mailu, členství a stav organizace, projektu i integrace. Nový klíč stejné integrace nemusí pomoci.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
integration_revoked
Správa API přístupu v aplikaci · HTTP 409
Situace: Integrace je zrušená nebo není aktivní.
Řešení: Ověřte životní cyklus integrace. Zrušenou integraci nelze obnovit. Čekající a již předané zprávy posuzujte samostatně; nový klíč starou práci neodvolá.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
internal_error
Veřejné API · HTTP 500
Situace: Server požadavek nedokončil nebo jej odmítl mimo konkrétní doménovou chybu.
Řešení: Použijte HTTP status, request_id a dostupné fields. Při 5xx či ztrátě spojení ověřte výsledek; odpověď proxy nemusí být JSON. Opravte metodu či Content-Type při 4xx, trvající selhání předejte podpoře.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
invalid_allowed_ips
Správa API přístupu v aplikaci · HTTP 422
Situace: Zadejte adresy IPv4 nebo IPv6, případně rozsah jako 203.0.113.0/24. Nejvýše 20 položek.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_api_key
Veřejné API · HTTP 401
Situace: Chybí platný strojový přístup, klíč byl zrušený nebo mu skončila platnost.
Řešení: Ověřte Authorization: Bearer, správnou integraci a platnost klíče. Vlastník nebo administrátor jej nahradí; klíč neposílejte v URL ani podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_capacity_change
Správa API přístupu v aplikaci · HTTP 422
Situace: Načtěte aktuální verzi kapacity a změnu zopakujte.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_capacity_limits
Správa API přístupu v aplikaci · HTTP 422
Situace: Limit je mimo povolený rozsah.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_changed_since
Veřejné API · HTTP 422
Situace: Neplatné datum změny.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Zadejte platnou e-mailovou adresu.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_event_cursor
Veřejné API · HTTP 422
Situace: Kurzor neodpovídá integraci, projektu nebo režimu.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_event_limit
Veřejné API · HTTP 422
Situace: Neplatná velikost stránky.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_key_expiry
Správa API přístupu v aplikaci · HTTP 422
Situace: Platnost klíče musí být v budoucnu, nejvýše 366 dnů.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_mode
Správa API přístupu v aplikaci · HTTP 422
Situace: Vyberte ostrý nebo testovací režim.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_name
Správa API přístupu v aplikaci · HTTP 422
Situace: Zadejte název integrace.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Neplatná velikost stránky.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_receipt_windows
Správa API přístupu v aplikaci · HTTP 422
Situace: Ochranný otisk musí zůstat déle než samotný výsledek.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_result_period
Veřejné API · HTTP 422
Situace: Konec období musí následovat po začátku.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_result_recipient
Veřejné API · HTTP 422
Situace: Neplatná adresa filtru.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_retention_change
Správa API přístupu v aplikaci · HTTP 422
Situace: Zadejte lhůtu v rozsahu 30 až 36500 dní.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_scopes
Správa API přístupu v aplikaci · HTTP 422
Situace: Vyberte platná oprávnění.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_webhook_events
Veřejné API · HTTP 422
Situace: Vyberte podporované jedinečné typy událostí.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_webhook_name
Veřejné API · HTTP 422
Situace: Zadejte název webhooku.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_webhook_state
Veřejné API · HTTP 422
Situace: Vyberte stav webhooku.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
invalid_webhook_url
Veřejné API · HTTP 422
Situace: Adresa webhooku nesplňuje pravidla veřejného HTTPS cíle nebo ji nelze bezpečně přeložit.
Řešení: Použijte veřejný HTTPS endpoint bez přesměrování a privátních síťových adres. Opravte DNS a dostupnost; nevypínejte ověřování TLS ani ochranu proti SSRF.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
ip_not_allowed
Veřejné API · HTTP 403
Situace: Požadavek přišel z adresy, která není v seznamu povolených IP adres integrace.
Řešení: Volejte API z povolené adresy, nebo ať vlastník či administrátor adresu doplní (v aplikaci API a integrace → integrace → Povolené IP adresy). Klíč zůstává platný.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
key_not_found
Správa API přístupu v aplikaci · HTTP 404
Situace: Klíč nebyl nalezen.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
load_test_key_restricted
Veřejné API · HTTP 403
Situace: Klíč zátěžového testu smí jen odeslat transakční zprávu.
Řešení: Klíč zátěžového testu vytváří a ruší aplikace sama pro noční běh na adresy simulátoru Amazon SES. Klientská integrace takový klíč nikdy nedostane; vlastní požadavky posílejte svým klíčem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
load_test_outside_night
Veřejné API · HTTP 403
Situace: Klíč zátěžového testu odesílá jen od 22:00 do 6:00 pražského času.
Řešení: Klíč zátěžového testu vytváří a ruší aplikace sama pro noční běh na adresy simulátoru Amazon SES. Klientská integrace takový klíč nikdy nedostane; vlastní požadavky posílejte svým klíčem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
load_test_recipient_not_simulator
Veřejné API · HTTP 422
Situace: Klíč zátěžového testu posílá jen na adresy simulátoru Amazon SES.
Řešení: Klíč zátěžového testu vytváří a ruší aplikace sama pro noční běh na adresy simulátoru Amazon SES. Klientská integrace takový klíč nikdy nedostane; vlastní požadavky posílejte svým klíčem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
delivery_test_key_restricted
Veřejné API · HTTP 403
Situace: Klíč testu doručení smí jen odeslat transakční zprávu.
Řešení: Klíč testu doručení vytváří a ruší aplikace sama pro test doručení do schránek z administrace. Klientská integrace takový klíč nikdy nedostane; vlastní požadavky posílejte svým klíčem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
delivery_test_recipient_not_mailbox
Veřejné API · HTTP 422
Situace: Klíč testu doručení posílá jen na uložené schránky testu doručení.
Řešení: Klíč testu doručení vytváří a ruší aplikace sama pro test doručení do schránek z administrace. Klientská integrace takový klíč nikdy nedostane; vlastní požadavky posílejte svým klíčem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
marketing_permission_required
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
operation_not_found
Veřejné API · HTTP 404
Situace: Operace nebyla nalezena.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
organization_closed
Veřejné API · HTTP 403
Situace: Projekt nyní nepovoluje správu integrací.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
organization_dispatch_disabled
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
organization_restricted
Veřejné API · HTTP 403
Situace: Projekt nyní nepovoluje správu integrací.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
organization_unavailable
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Správa API přístupu v aplikaci · HTTP 403
Situace: Kapacitu přiděluje oprávněný správce platformy.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
product_policy_mismatch
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
product_sending_capability_required
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Veřejné API · HTTP 409
Situace: Operace vyžaduje skutečný použitelný kontakt, nikoli ukázkový podklad.
Řešení: Použijte existující kontakt vlastního projektu s doloženým původem a potřebnými odběry. Ukázková data nepřeznačujte na skutečné příjemce jen kvůli obejití kontroly.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
project_not_found
Veřejné API · HTTP 404
Situace: Projekt nebyl nalezen.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
project_scope_mismatch
Správa API přístupu v aplikaci · HTTP 403
Situace: Vyberte právě otevřený projekt.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
provider_route_not_ready
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
rate_limited
Veřejné API · HTTP 429
Situace: Byl dosažen limit požadavků, příjemců nebo čekající fronty.
Řešení: Rozlište HTTP limit od kapacity příjemců a tarifu. Respektujte Retry-After, snižte souběh, sledujte odbavení fronty a aktuální capacity.limits. Série cizích projektů či chybných klíčů vyžaduje opravu integrace.
Opakování: Po Retry-After opakujte stejnou operaci s původním klíčem a omezeným počtem pokusů. Rotace klíče limit nevynuluje.
reputation_paused
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
request_rejected
Veřejné API · HTTP 4xx (např. 400)
Situace: Server požadavek nedokončil nebo jej odmítl mimo konkrétní doménovou chybu.
Řešení: Použijte HTTP status, request_id a dostupné fields. Při 5xx či ztrátě spojení ověřte výsledek; odpověď proxy nemusí být JSON. Opravte metodu či Content-Type při 4xx, trvající selhání předejte podpoře.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
request_too_large
Veřejné API · HTTP 413
Situace: JSON tělo překročilo hranici 1 MiB (1 048 576 bajtů), nebo kontakty z POST /contacts/bulk po převodu přesáhly 750 000 znaků.
Řešení: Zmenšete obsah nebo rozdělte dávku při zachování limitu příjemců (transakce nejvýše 50, kontakty nejvýše 1 000 v jednom požadavku). Každá nová dávka má vlastní klíč. Vícebajtové znaky také spotřebovávají limit.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
retention_policy_unavailable
Veřejné API · HTTP 409, 503
Situace: Provozovatel nemá nastavenou platnou politiku uchování dat; odesílání čeká na nápravu u podpory.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
retention_version_conflict
Správa API přístupu v aplikaci · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
scope_required
Veřejné API · HTTP 403
Situace: Operace nebo události webhooku potřebují oprávnění, které integrace nemá.
Řešení: Porovnejte scope operace s oprávněními integrace. Správce přidělí jen potřebný přístup; změna URL ani opakování oprávnění nezíská.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
scope_unavailable
Správa API přístupu v aplikaci · HTTP 422
Situace: Toto oprávnění je zatím označené Připravujeme.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
scopes_conflict
Správa API přístupu v aplikaci · HTTP 409
Situace: Oprávnění mezitím někdo změnil. Obnovte integraci a změnu zopakujte.
Řešení: Načtěte aktuální detail, readiness a povolené akce příslušného objektu. Rozlište rozpracovaný, již ukončený a změněný stav; při trvajícím konfliktu předejte code a request_id podpoře.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
sending_clearance_required
Veřejné API · HTTP 409
Situace: Chybí požadované povolení k zahájení odesílání.
Řešení: Načtěte připravenost kampaně nebo zprávy a dokončete předepsané kontroly a potvrzení oprávněnou osobou. Pouhá existence šablony nebo API klíče povolení nezíská.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
sending_limits_missing
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Stav nebo vazby objektu nepovolují změnu, archivaci či odstranění.
Řešení: Ověřte aktivní schválení, dispatch a navazující použití. Použijte jen nabízenou akci zrušení před zahájením; systémové či publikované objekty nepřepisujte násilím.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 422
Situace: Vstup, podmínka nebo definice objektu neprošly validací.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Stejný název nebo identita už v daném rozsahu existují.
Řešení: Vyhledejte existující objekt a podle záměru jej použijte nebo upravte s aktuální verzí. Pro nový objekt zvolte odlišnou identitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 404
Situace: Objekt není dostupný v rozsahu tohoto projektu nebo už neexistuje.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Sdílená doménová kontrola · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
support_not_allowed
Veřejné API · HTTP 403
Situace: Požadavek kombinuje veřejné API s kontextem podpory.
Řešení: Odeberte hlavičku x-ng-support-session. Použijte přímý projektový API klíč; support relace a cookies jej nenahrazují.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
suppression_active
Veřejné API · HTTP 409
Situace: Příjemce je blokovaný nebo nelze blokaci bezpečně ověřit.
Řešení: U aktivní blokace respektujte důvod a příslušný rozsah. Při nedostupnosti kontroly předejte request_id podpoře a vyčkejte obnovy; kontrolu nevypínejte a novým kontaktem ji neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
suppression_lookup_unavailable
Veřejné API · HTTP 503
Situace: Příjemce je blokovaný nebo nelze blokaci bezpečně ověřit.
Řešení: U aktivní blokace respektujte důvod a příslušný rozsah. Při nedostupnosti kontroly předejte request_id podpoře a vyčkejte obnovy; kontrolu nevypínejte a novým kontaktem ji neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
template_published_locked
Veřejné API · HTTP 409
Situace: Transakční šablona už má publikovanou verzi; úprava (PUT /templates/{templateId}) ani publikace jiné verze nejsou povolené, aby se ostré odesílání nezměnilo pod rukama.
Řešení: Vytvořte kopii přes POST /templates/{templateId}/duplicate (nové template_id, nepublikovaná), upravte ji přes PUT, publikujte a v integraci přejděte na nové template_id s pevnou template_version. Původní šablona a její verze dál odesílají beze změny.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_already_cancelled
Veřejné API · HTTP 409
Situace: Zpráva už je zrušená.
Řešení: Ověřte mode, simulated, reason a detail zprávy. Expirace, zrušení ani simulation_only se nepovažují za doručení.
Opakování: Automaticky nevytvářejte náhradní zprávu. Nové skutečné odeslání musí být nový vědomý záměr.
transactional_batch_not_found
Veřejné API · HTTP 404
Situace: Reference nebyla nalezena v tomto projektu.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_batch_too_large
Veřejné API · HTTP 422
Situace: Dávka překračuje povolený počet příjemců.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_batch_unreadable
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Rezervovanou transakční zprávu nelze bezpečně načíst.
Řešení: Zachovejte ID zprávy a předejte je s request_id podpoře. Provozovatel ověří obsah, šifrování a integritu evidence. Nové publikování šablony již přijatou zprávu neopraví a nový klíč může vytvořit duplicitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_cancel_not_possible
Veřejné API · HTTP 409
Situace: Příprava nebo předání už začaly, případně je požadavek ukončený.
Řešení: Načtěte aktuální stav a povolené akce. Zrušení či přeplánování nelze vynutit nad rozpracovaným nebo již předaným požadavkem.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_cancelled_by_user
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Požadavek byl zrušen před prvním předáním SES.
Řešení: Ověřte mode, simulated, reason a detail zprávy. Expirace, zrušení ani simulation_only se nepovažují za doručení.
Opakování: Automaticky nevytvářejte náhradní zprávu. Nové skutečné odeslání musí být nový vědomý záměr.
transactional_confirmation_required
Správa API přístupu v aplikaci · HTTP 422
Situace: Potvrďte skutečné odeslání na uvedenou adresu.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_control_version_conflict
Veřejné API · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_crypto_unavailable
Veřejné API · HTTP 503
Situace: Ruční test není dostupný.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_custom_limit_invalid
Správa API přístupu v aplikaci · HTTP 422
Situace: Vlastní limit musí být celé číslo v rozsahu přidělené kapacity.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_detail_expired
Veřejné API · HTTP 404, 410
Situace: Vypršela dostupnost detailu nebo kurzoru událostí.
Řešení: Začněte nové čtení událostí a dorovnejte jej podle vlastní evidence a zachovaných výsledků. Po odstranění dat může následovat 404; lhůty detailu a idempotence jsou různé.
Opakování: Expirace historie není důkaz neodeslání. Automaticky neposílejte náhradní e-mail.
transactional_detail_unavailable
Veřejné API · HTTP 503
Situace: Reference události není dostupná.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_erasure_busy
Veřejné API · HTTP 409
Situace: Některá zpráva příjemce se právě odesílá nebo zpracovává. Zkuste výmaz za chvíli zopakovat.
Řešení: Ověřte oprávnění transactional:erase, ostrý režim, přesnou adresu a předepsané potvrzení. Výmaz provádějte jen jako výslovně schválenou akci; při busy respektujte čekání.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_erasure_confirmation_mismatch
Veřejné API · HTTP 422
Situace: Adresy se neshodují. Nic nebylo smazáno.
Řešení: Ověřte oprávnění transactional:erase, ostrý režim, přesnou adresu a předepsané potvrzení. Výmaz provádějte jen jako výslovně schválenou akci; při busy respektujte čekání.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_erasure_forbidden
Veřejné API · HTTP 403
Situace: Aktuální role, členství nebo stav přístupu operaci nepovolují.
Řešení: Vlastník zkontroluje roli zakladatele, ověření e-mailu, členství a stav organizace, projektu i integrace. Nový klíč stejné integrace nemusí pomoci.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_erasure_invalid_address
Veřejné API · HTTP 422
Situace: Zadejte platnou e-mailovou adresu.
Řešení: Ověřte oprávnění transactional:erase, ostrý režim, přesnou adresu a předepsané potvrzení. Výmaz provádějte jen jako výslovně schválenou akci; při busy respektujte čekání.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_erasure_live_only
Veřejné API · HTTP 403
Situace: Výmaz dat příjemce vyžaduje ostrý klíč. Testovací klíč nic nemaže.
Řešení: Ověřte oprávnění transactional:erase, ostrý režim, přesnou adresu a předepsané potvrzení. Výmaz provádějte jen jako výslovně schválenou akci; při busy respektujte čekání.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_erasure_rate_limited
Veřejné API · HTTP 429
Situace: Projekt dosáhl hodinového limitu žádostí o výmaz. Zkuste to později.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_erasure_scope_not_found
Veřejné API · HTTP 404
Situace: Projekt nebyl nalezen.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_erasure_unavailable
Veřejné API · HTTP 503
Situace: Výmaz teď nelze bezpečně provést. Nic nebylo smazáno. Zkuste to později nebo kontaktujte podporu.
Řešení: Respektujte Retry-After a načtěte aktuální stav původního požadavku. Při trvajícím selhání předejte code a request_id podpoře; znovu založený objekt ani klíč výpadek služby neřeší.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_event_route_unavailable
Veřejné API · HTTP 503
Situace: Odesílání transakčních e-mailů zatím není zapnuté. Kontaktujte podporu.
Řešení: Zkontrolujte sender_profile_id, projekt, připravenost odesílatele, DNS a stav odesílací cesty. Chybné či změněné nastavení řeší vlastník nebo podpora; připravenost neobcházejte.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_expiry_invalid
Veřejné API · HTTP 422
Situace: expires_at není v povoleném intervalu.
Řešení: Nastavte čas nejméně 60 sekund v budoucnu a nejvýše podle capacity.limits.queue_expiry_seconds. Původně přijaté zprávě nová expirace neprodlouží platnost.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
Veřejné API · HTTP 422
Situace: Požadavek neodpovídá schématu nebo deklarovaným vstupům šablony.
Řešení: Opravte konkrétní fields podle OpenAPI a publikované verze šablony. Ověřte povinná pole a typy; při příjmu neplatné transakční dávky se odmítá celá dávka.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_integration_paused
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Integrace, projekt nebo požadavek jsou pozastavené.
Řešení: Zjistěte rozsah pauzy. Pauza integrace odmítá nové zápisy; pauza transakčního projektu může dál přijímat do fronty. Obnovení musí provést oprávněný správce. Platnost fronty dál běží.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_integration_revoked
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Integrace je zrušená nebo není aktivní.
Řešení: Ověřte životní cyklus integrace. Zrušenou integraci nelze obnovit. Čekající a již předané zprávy posuzujte samostatně; nový klíč starou práci neodvolá.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_manual_limit
Správa API přístupu v aplikaci · HTTP 429
Situace: Kapacita ručních testů je vyčerpaná.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_message_not_found
Veřejné API · HTTP 404, 410
Situace: Zpráva nebyla nalezena.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_preview_required
Správa API přístupu v aplikaci · HTTP 422
Situace: Odesílatel se od náhledu změnil. Znovu zkontrolujte náhled.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_queue_expired
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Zprávě ve frontě skončila platnost.
Řešení: Ověřte mode, simulated, reason a detail zprávy. Expirace, zrušení ani simulation_only se nepovažují za doručení.
Opakování: Automaticky nevytvářejte náhradní zprávu. Nové skutečné odeslání musí být nový vědomý záměr.
transactional_queue_limit
Veřejné API · HTTP 429
Situace: Byl dosažen limit požadavků, příjemců nebo čekající fronty.
Řešení: Rozlište HTTP limit od kapacity příjemců a tarifu. Respektujte Retry-After, snižte souběh, sledujte odbavení fronty a aktuální capacity.limits. Série cizích projektů či chybných klíčů vyžaduje opravu integrace.
Opakování: Po Retry-After opakujte stejnou operaci s původním klíčem a omezeným počtem pokusů. Rotace klíče limit nevynuluje.
transactional_read_forbidden
Veřejné API · HTTP 403
Situace: Aktuální role, členství nebo stav přístupu operaci nepovolují.
Řešení: Vlastník zkontroluje roli zakladatele, ověření e-mailu, členství a stav organizace, projektu i integrace. Nový klíč stejné integrace nemusí pomoci.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_recipient_blocked
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Účinná ochrana příjemce blokuje odeslání.
Řešení: Ověřte důvod ve výsledku zprávy a kontrole blokací. Trvalé nedoručení, stížnost ani zákaz neobcházejte novým kontaktem či klíčem.
Opakování: Blokovanému příjemci automaticky neposílejte znovu.
transactional_recipient_export_forbidden
Správa API přístupu v aplikaci · HTTP 403
Situace: Výpis dat příjemce stáhne jen vlastník nebo administrátor projektu, podpora jen s povolenými úpravami.
Řešení: Vlastník ověří roli, scope, režim a příslušnou funkci tarifu. Support režim nesmí překročit práva klienta; ochranu neobcházejte.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_recipient_limit
Veřejné API · HTTP 429
Situace: Byl dosažen limit požadavků, příjemců nebo čekající fronty.
Řešení: Rozlište HTTP limit od kapacity příjemců a tarifu. Respektujte Retry-After, snižte souběh, sledujte odbavení fronty a aktuální capacity.limits. Série cizích projektů či chybných klíčů vyžaduje opravu integrace.
Opakování: Po Retry-After opakujte stejnou operaci s původním klíčem a omezeným počtem pokusů. Rotace klíče limit nevynuluje.
transactional_reference_closed
Veřejné API · HTTP 409
Situace: Reference odkazuje na uzavřený nebo odlišný požadavek.
Řešení: Načtěte původní požadavek a jeho výsledky podle reference. Jiný obsah nespojujte se starou identitou; po dokončení či uzavření neposílejte automatickou náhradu bez ověření obchodního záměru.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_reference_conflict
Veřejné API · HTTP 503
Situace: Reference odkazuje na uzavřený nebo odlišný požadavek.
Řešení: Načtěte původní požadavek a jeho výsledky podle reference. Jiný obsah nespojujte se starou identitou; po dokončení či uzavření neposílejte automatickou náhradu bez ověření obchodního záměru.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_reference_key_unavailable
Veřejné API · HTTP 503
Situace: Klíč historického řízení referencí není dostupný. Obraťte se na podporu.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_render_failed
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Otisk neměnného obsahu neodpovídá uloženým podkladům.
Řešení: Zachovejte ID zprávy a předejte je s request_id podpoře. Provozovatel ověří obsah, šifrování a integritu evidence. Nové publikování šablony již přijatou zprávu neopraví a nový klíč může vytvořit duplicitu.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_reply_to_invalid
Veřejné API · HTTP 422
Situace: Adresa pro odpovědi u šablony není platná nebo patří platformě. Upravte ji v nastavení šablony.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_request_paused
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Integrace, projekt nebo požadavek jsou pozastavené.
Řešení: Zjistěte rozsah pauzy. Pauza integrace odmítá nové zápisy; pauza transakčního projektu může dál přijímat do fronty. Obnovení musí provést oprávněný správce. Platnost fronty dál běží.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_request_target_invalid
Veřejné API · HTTP 422
Situace: Vyberte jeden požadavek nebo jednu společnou referenci.
Řešení: Opravte fields podle schématu příslušné operace. U kontaktů zkontrolujte vlastní pole a právní podklad, u šablon deklarované inputs, u automatizací definici a vazby bloků.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_request_target_too_large
Veřejné API · HTTP 422
Situace: Referenci rozdělte na menší části.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_route_changed
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Uložená odesílací cesta již neodpovídá aktuální připravenosti.
Řešení: Zkontrolujte sender_profile_id, projekt, připravenost odesílatele, DNS a stav odesílací cesty. Chybné či změněné nastavení řeší vlastník nebo podpora; připravenost neobcházejte.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_sender_required
Veřejné API · HTTP 422
Situace: Zadejte odesílací profil, nebo ho nastavte jako výchozí u šablony.
Řešení: Zkontrolujte sender_profile_id, projekt, připravenost odesílatele, DNS a stav odesílací cesty. Chybné či změněné nastavení řeší vlastník nebo podpora; připravenost neobcházejte.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_sender_unavailable
Veřejné API · HTTP 422
Situace: Vyberte dostupný odesílací profil tohoto projektu.
Řešení: Zkontrolujte sender_profile_id, projekt, připravenost odesílatele, DNS a stav odesílací cesty. Chybné či změněné nastavení řeší vlastník nebo podpora; připravenost neobcházejte.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_sending_paused
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Integrace, projekt nebo požadavek jsou pozastavené.
Řešení: Zjistěte rozsah pauzy. Pauza integrace odmítá nové zápisy; pauza transakčního projektu může dál přijímat do fronty. Obnovení musí provést oprávněný správce. Platnost fronty dál běží.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
transactional_simulation_only
Následné zpracování zprávy · Související odmítnutí HTTP 409
Situace: Simulovaná zpráva nesmí být předána SES.
Řešení: Ověřte mode, simulated, reason a detail zprávy. Expirace, zrušení ani simulation_only se nepovažují za doručení.
Opakování: Automaticky nevytvářejte náhradní zprávu. Nové skutečné odeslání musí být nový vědomý záměr.
transactional_template_unpublished
Veřejné API · HTTP 422
Situace: Vybraná šablona nemá použitelnou publikovanou transakční revizi.
Řešení: Načtěte katalog transakčních šablon ve stejném projektu, vyberte publikovanou verzi a ověřte deklaraci inputs. Koncept nestačí.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_template_version_not_found
Veřejné API · HTTP 404
Situace: Publikovaná verze transakční šablony nebyla nalezena.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transactional_write_forbidden
Veřejné API · HTTP 403
Situace: Aktuální role, členství nebo stav přístupu operaci nepovolují.
Řešení: Vlastník zkontroluje roli zakladatele, ověření e-mailu, členství a stav organizace, projektu i integrace. Nový klíč stejné integrace nemusí pomoci.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
transport_worker_not_ready
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Veřejné API · HTTP 415
Situace: Tělo požadavku nemá Content-Type application/json.
Řešení: Pošlete tělo jako JSON s hlavičkou Content-Type: application/json (případně s charset=utf-8). Požadavek nebyl přijat, nic nevzniklo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
validation_error
Veřejné API · HTTP 422
Situace: Požadavek neodpovídá schématu nebo deklarovaným vstupům šablony.
Řešení: Opravte konkrétní fields podle OpenAPI a publikované verze šablony. Ověřte povinná pole a typy; při příjmu neplatné transakční dávky se odmítá celá dávka.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_archived
Veřejné API · HTTP 409
Situace: Webhook je archivovaný, vypnutý nebo se volá akce nepovolená v simulaci.
Řešení: Ověřte stav a režim cíle. Zapnutí, vytvoření nového cíle či použití ostrého režimu je vědomá správa integrace, nikoli automatický retry.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_crypto_unavailable
Veřejné API · HTTP 503
Situace: Nastavení webhooku nelze bezpečně přečíst.
Řešení: Respektujte Retry-After a předejte podpoře čas, code a request_id. Provozovatel ověří službu, routování událostí a klíče; tajemství neposílejte. U časového limitu zmenšete požadovaný rozsah.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
webhook_delivery_expired
Veřejné API · HTTP 410
Situace: Vypršela dostupnost detailu nebo kurzoru událostí.
Řešení: Začněte nové čtení událostí a dorovnejte jej podle vlastní evidence a zachovaných výsledků. Po odstranění dat může následovat 404; lhůty detailu a idempotence jsou různé.
Opakování: Expirace historie není důkaz neodeslání. Automaticky neposílejte náhradní e-mail.
webhook_delivery_not_found
Veřejné API · HTTP 404
Situace: Doručení webhooku nebylo nalezeno.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_disabled
Veřejné API · HTTP 409
Situace: Webhook je archivovaný, vypnutý nebo se volá akce nepovolená v simulaci.
Řešení: Ověřte stav a režim cíle. Zapnutí, vytvoření nového cíle či použití ostrého režimu je vědomá správa integrace, nikoli automatický retry.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_dns_unavailable
Veřejné API · HTTP 503
Situace: Adresa webhooku nesplňuje pravidla veřejného HTTPS cíle nebo ji nelze bezpečně přeložit.
Řešení: Použijte veřejný HTTPS endpoint bez přesměrování a privátních síťových adres. Opravte DNS a dostupnost; nevypínejte ověřování TLS ani ochranu proti SSRF.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
webhook_live_only
Veřejné API · HTTP 409
Situace: Webhook je archivovaný, vypnutý nebo se volá akce nepovolená v simulaci.
Řešení: Ověřte stav a režim cíle. Zapnutí, vytvoření nového cíle či použití ostrého režimu je vědomá správa integrace, nikoli automatický retry.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_not_found
Veřejné API · HTTP 404
Situace: Webhook nebyl nalezen.
Řešení: Zkontrolujte projekt klíče a ID z aktuálního výpisu. Simulovaně vytvořený běžný objekt není trvalý. Cizí ID ani změna URL přístup neposkytnou.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_retry_conflict
Veřejné API · HTTP 409
Situace: Doručení není v opakovatelném stavu, změnil se počet pokusů nebo je vyčerpaný jejich limit.
Řešení: Načtěte detail doručení a aktuální expected_attempt_count. Ruční opakování zachová event_id a přidělený limit; vytvoření nového e-mailu není řešení webhooku.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_scope_missing
Veřejné API · HTTP 409
Situace: Operace nebo události webhooku potřebují oprávnění, které integrace nemá.
Řešení: Porovnejte scope operace s oprávněními integrace. Správce přidělí jen potřebný přístup; změna URL ani opakování oprávnění nezíská.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_target_limit
Veřejné API · HTTP 429
Situace: Integrace vyčerpala přidělený počet webhooků.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_target_not_public
Veřejné API · HTTP 422
Situace: Adresa webhooku nesplňuje pravidla veřejného HTTPS cíle nebo ji nelze bezpečně přeložit.
Řešení: Použijte veřejný HTTPS endpoint bez přesměrování a privátních síťových adres. Opravte DNS a dostupnost; nevypínejte ověřování TLS ani ochranu proti SSRF.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
webhook_version_conflict
Veřejné API · HTTP 409
Situace: Objekt nebo jeho podklady se změnily od posledního načtení, případně už bylo rozhodnuto.
Řešení: Načtěte aktuální objekt, expectedVersion či expected_version a neměnné podklady. Znovu vyhodnoťte svůj záměr; nepřepisujte novější stav starými údaji.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
webhook_version_limit
Veřejné API · HTTP 409
Situace: Pro další nastavení založte nový webhook.
Řešení: Porovnejte konkrétní pole s OpenAPI, capacity.limits, tarifem a aktuálními počty. Zmenšete dávku, rozsah nebo souběh. Zvýšení kapacity řeší správce, rotace klíče nepomůže.
Opakování: Neopakujte automaticky. Nejdříve opravte uvedenou podmínku a ověřte, zda původní operace již neproběhla.
workspace_closed
Veřejné API · HTTP 403
Situace: Projekt nyní nepovoluje správu integrací.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
workspace_paused
Veřejné API · HTTP 403
Situace: Projekt nyní nepovoluje správu integrací.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
workspace_unavailable
Veřejné API · HTTP 409
Situace: Aktuální odesílací brány nepovolují transakční zprávu.
Řešení: Načtěte připravenost a její checks či blockedBy. Rozlište tarif bez odesílání, vyčerpaný objem, pozastavení organizace, doménu, reputaci a infrastrukturu. Vlastník řeší tarif; provozovatel runtime a ochranné brány. Nic nezapínejte naslepo.
Opakování: Po odstranění příčiny opakujte nezměněný zápis s původním Idempotency-Key. Při změně těla nejprve dohledávejte původní výsledek a teprve pak použijte nový klíč.
Příklady
Všechny hodnoty jsou syntetické. Nahraďte ID a proměnnou prostředí vlastním testovacím klíčem. Tato stránka nemá tlačítko pro ostré spuštění.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/groups' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: group-example-0001' \
--data '{"name":"Zákazníci e-shopu"}'
POST /contacts přijímá contact a evidence, POST /contacts/bulk pole contacts (1–1000; větší objem po dávkách podle kapitoly Hromadné nahrání kontaktů). Obě operace vyžadují addressAttestation:true a privacyAttestation:true a vrátí 202 s identifikátorem importu job_id, trvalým request.id a počty řádků; kontakty se následně zpracují na pozadí. GET /contact-imports/{job_id}/readiness ukazuje postup, výsledek a případný vadný řádek. Stejný Idempotency-Key nevytvoří druhou práci. U dávky se vrátí počty neplatných a duplicitních řádků, u jediného neplatného kontaktu 422 bez práce.
evidence obsahuje processingBasis, marketingPermissionBasis a evidenceObservedAt, volitelně konkrétní doklad a zdroj. Marketingové none s doloženým contract/consent/legitimate_interests uloží pouze kontakt a podklad: nepřihlásí odběr ani nepřepíše existující oprávnění. Skupiny určují jen targetListIds. Vlastní pole musí být předem definovaná v projektu. Pro multiselect načtěte povolené options přes GET /contact-fields. Při vytvoření kontaktu nebo dávky posílejte například customFields: {"zajmy": ["Sport", "Cestování"]}; podporován je i dosavadní seznam zakódovaný v řetězci. Vybrané možnosti musí přesně odpovídat definici a nesmějí se opakovat. API z hodnot nové možnosti nevytváří. Prázdný seznam znamená nevyplněno. JSON seznam lze použít pouze pro typ multiselect. Odpověď kontaktu a PATCH profilu nadále používají JSON seznam zakódovaný v řetězci. Číselné vlastní pole přijme celé i desetinné číslo s tečkou nebo čárkou, se znaménkem a exponentem (12, 12,5, -3, 1e3); mezery uvnitř čísla, text a 0x10 neplatí, prázdná hodnota znamená bez hodnoty. Platí stejné pravidlo jako ve formuláři a v aplikaci. Neplatná hodnota udělá z řádku dávky neplatný řádek; jediný kontakt vrátí 422 contact_intake_invalid s chybou u pole, například "/contact/customFields/orders": "Hodnota není číslo.". Hodnotu z požadavku chyba neopakuje. Chráněná blokace přežije i nový import stejné adresy.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/contacts' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: contact-create-example-0001' \
--data '{"contact":{"email":"synthetic@example.test","firstName":"Jana","lastName":"Ukázková"},"evidence":{"processingBasis":"contract","marketingPermissionBasis":"none","evidenceObservedAt":"2026-10-06T08:00:00Z","evidenceReference":"Syntetická objednávka TEST-100"},"addressAttestation":true,"privacyAttestation":true}'
Úprava kontaktu
Nejdříve načtěte detail a použijte jeho aktuální verzi. Profilový zápis nenahrazuje doložení oprávnění ani přihlášení k odběru.
curl -X PATCH 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/contacts/cnt_00000000000000000000000000000001/profile' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: contact-example-0001' \
--data '{"expectedVersion":1,"firstName":"Jana","lastName":"Ukázková","locale":"cs-CZ","city":null,"company":null,"country":null,"customFields":{},"phone":null,"postalCode":null}'
Šablona ve společné knihovně
Počet aktivních šablon v projektu hlídá tarif. GET /templates vrací activeCount, productLimit a effectiveLimit. Placený tarif bez limitu má productLimit: null a effectiveLimit je technická pojistka 1000; bezplatný tarif má productLimit nejvýš 50. Archivované šablony ani revize se nepočítají. Po dosažení hranice vrátí vytvoření i návrat z archivu 409 campaign_email_template_limit_reached. Parametr q hledá bez ohledu na diakritiku a velikost písmen; šablona vyhoví, když každé slovo dotazu najde v názvu nebo ve štítku.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/templates' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: template-example-0001' \
--data '{"name":"Ukázková šablona","category":"Ukázky","tags":[],"subjectTemplate":"Ukázková zpráva","previewTextTemplate":"Náhled","textTemplate":"Dobrý den {{first_name}}","document":{"schemaVersion":1,"settings":{"accentColor":"#178f5d","backgroundColor":"#f4f7f5","contentColor":"#ffffff","contentWidth":640,"textColor":"#17352a"},"blocks":[{"id":"text_example","type":"text","text":"Dobrý den {{first_name}}","tone":"default"}]}}'
Transakční šablona a vstupy
GET /templates/{templateId} vrací u transakční šablony také inputSchema.fields pro aktuální pracovní revizi. Každé pole obsahuje key, label, type, required a případná omezení a example; číselné a logické příklady zůstávají číslem a boolean hodnotou. Marketingová šablona transakční schéma nevrací. Přesnou revizi stáhnete přes GET /templates/{templateId}/versions/{version}. Pro ostré odesílání čtěte publikovaný katalog GET /transactional/templates a deklaraci GET /transactional/templates/{templateId}/versions/{version}: stejná definice polí je tam pod input_schema.fields, bez přimíchání novějšího konceptu.
Ve stejné knihovně nastavte purpose: transactional a inputSchema. Dostupné typy jsou text, number, boolean, date (RRRR-MM-DD), url (HTTPS) a email. Název URL pole může být libovolný platný klíč. Nejvýše 64 polí a 128 KiB schématu. Tělo JSON se nepřevádí mezi typy. Neznámé nebo prázdné/null hodnoty jsou neplatné; konkrétní pole vrací chyba 422.
Každá revize uchovává vlastní schéma. POST /templates/{templateId}/versions/{version}/preview přijímá {"inputs":{...}}, nic neposílá a nestahuje URL. POST /templates/{templateId}/versions/{version}/publish s Idempotency-Key publikuje přesnou aktuální uloženou revizi. Dokud transakční šablona nemá publikovanou verzi, editace vytvoří nový nepublikovaný návrh. Kopie ani obnova automaticky nepublikují. Samotná publikace není odeslání zprávy.
Publikovaná transakční šablona se nemění. Jakmile má transakční šablona publikovanou verzi, PUT /templates/{templateId} i publikace jiné verze vrátí 409 template_published_locked; opakovaná publikace téže verze zůstává povolená. Změnu vydejte jako kopii: POST /templates/{templateId}/duplicate (oprávnění templates:write, hlavička Idempotency-Key, tělo {"name":"…","source_version":2}, obě pole nepovinná) vrátí 201 s novou nepublikovanou šablonou s novým template_id. Zdrojem je source_version, jinak publikovaná verze, jinak aktuální. Kopie převezme obsah, vstupní pole, druh, odhlašovací adresu, výchozího odesílatele, měření a štítky; bez name dostane název „<název> (kopie)“, při obsazení „(kopie 2)“ atd. Kopii upravte, publikujte a v integraci přejděte na nové template_id s pevnou template_version. Původní šablona a její verze dál odesílají beze změny. Marketingové šablony a dosud nepublikované transakční šablony se upravují jako dřív.
Náhradní hodnota značky. Značka {{first_name|"zákazníku"}} dosadí text v uvozovkách, když údaj chybí, je prázdný nebo je jen z mezer; mezery kolem názvu a svislítka jsou povolené. Náhradní hodnota je prostý text do 100 znaků v rovných uvozovkách bez složených závorek; uvozovku zapište ", zpětné lomítko \. Do HTML se escapuje jako údaj. Platí v předmětu, úvodním textu, textu i textové verzi, ne v adresách odkazů a ne u systémových odkazů (422 u pole). U povinného vstupního pole se neuplatní, požadavek bez něj se odmítne jako dosud. used_variables vrací jen název značky (first_name). Značky bez svislítka se chovají jako dřív.
Výběr verze šablony. Verzi určuje dvojice template_id + template_version. Publikovaná verze se nemění a publikovanou transakční šablonu už nelze upravit; změna vzniká jako kopie s novým template_id (kopie publikované šablony). Požadavek s template_version použije přesně tu publikovanou verzi, i když už existuje novější. Požadavek bez template_version dostane nejnovější publikovanou verzi platnou při prvním přijetí, takže po publikaci nové verze dostávají další takové požadavky už ji. Ostré integrace proto mají posílat pevnou template_version a na novou verzi přejít vědomě. Číslo aktuální publikované verze vrací katalog v current_published_version.version a detail šablony GET /templates/{templateId} v publishedVersion. Detail vrací i version, tedy aktuální pracovní revizi: tu posílejte jako expectedVersion při PUT /templates/{templateId} a archivaci. Úplnou historii vrací GET /templates/{templateId}/versions (oprávnění templates:read; publikovaná revize má vyplněné publishedAt). Převzatá sdílená šablona má v cílovém projektu jedinou verzi, převzatou v aplikaci; historie běžné knihovny ji nevrací. Pevné číslo pak potvrdí deklarace GET /transactional/templates/{templateId}/versions/{version} s is_current_published a každá odpověď 202 vrací použitou verzi v result.template_version. Projekt si může v aplikaci zapnout přepsání publikované transakční šablony (Nastavení projektu, jen vlastník a administrátor): šablona si pak ponechá template_id a publikace vytvoří další verzi, kterou požadavky bez template_version dostanou hned. Veřejné API přepsání nenabízí a dál vrací 409 template_published_locked. Publikovat smí v aplikaci vlastník, administrátor a uživatel projektu a přes API klíč s oprávněním templates:write.
inputSchema.defaultSender nastaví výchozí odesílací profil šablony: senderProfileId (odesílací profil vlastního projektu) a volitelný replyTo (e-mailová adresa, nikdy na doméně platformy). Nová publikace transakční revize výchozí odesílací profil vyžaduje; bez něj vrátí 422 s chybou pole inputSchema.defaultSender. Dřív publikované verze bez profilu platí dál a přijímají požadavky s sender_profile_id. inputSchema.engagementTracking zapíná (true) nebo vypíná (false) měření otevření a prokliků u revize; chybí-li, platí výchozí hodnota projektu (dnes vypnuto). Obojí je součástí neměnné revize, takže pozdější úprava šablony už přijaté zprávy nezmění. Měření se vždy omezí na ověřenou měřicí adresu klientské domény.
Druh šablony. Nepovinné inputSchema.messageKind rozliší servisní šablonu (service) od marketingové zprávy odesílané transakční frontou (marketing). Chybí-li, platí service, takže dřívější šablony a volání se nemění. Druh je součástí neměnné revize. Katalog publikovaných šablon ho vrací jako message_kind u current_published_version i v deklaraci verze, takže lze zvlášť sledovat stížnosti u marketingových zpráv.
Odhlašovací adresa marketingové šablony. Revize druhu marketing se publikuje jen s inputSchema.unsubscribeUrl (HTTPS adresa stránky klienta, bez přihlašovacích údajů, nikdy doména platformy) a s odkazem přesně na tuto adresu v HTML těle i v textové části zprávy; jinak publikace vrátí 422 s chybou pole inputSchema.unsubscribeUrl (chybí adresa nebo odkaz v HTML), případně textTemplate (adresa chybí v textové části). Odkaz na tuto přesnou adresu se nikdy neměří ani nepřepisuje a zpráva nemá hlavičku List-Unsubscribe. Servisní šablona odhlašovací adresu nepotřebuje a značka {{unsubscribe_url}} zůstává u transakčních šablon zakázaná. Už publikované verze a jejich volání se nemění.
Značka odhlašovacího formuláře. Do obsahu transakční šablony můžete místo pevné adresy vložit systémovou značku {{unsubscribe_form_url}}, například do tlačítka. Při náhledu, ručním testu i odeslání se za ni dosadí inputSchema.unsubscribeUrl revize; integrace ji v inputs neposílá a pole tohoto jména nejde deklarovat. Značka je oddělená od {{unsubscribe_url}} marketingové rozesílky a funguje u servisní i marketingové šablony; v marketingové šabloně kampaní ji uložení odmítne. Revize, jejíž obsah značku používá, se publikuje jen s vyplněnou adresou, jinak 422 s chybou pole inputSchema.unsubscribeUrl, takže zpráva nikdy neodejde s prázdným odkazem. U marketingové šablony splní povinný odkaz na adresu i tlačítko nebo odkaz se značkou. Katalog vrací značku v used_variables. Systémové odkazy ({{unsubscribe_url}}, {{unsubscribe_all_url}}, {{manage_subscriptions_url}}, {{web_version_url}} a {{unsubscribe_form_url}}) patří jen do těla: nový nebo změněný subjectTemplate či previewTextTemplate s nimi u POST /templates, PUT /templates/{templateId} i PUT /campaigns/{campaignId}/content vrátí 422 campaign_email_subject_link_invalid s chybou u pole. Už uložený obsah, který je má, se dál čte, kopíruje i odesílá. Náhled rozpracované šablony bez adresy použije ukázkovou adresu https://example.com/odhlasovaci-formular?preview=1.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/templates' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: transactional-template-example-0001' \
--data '{"name":"Ukázková objednávka","category":"Objednávky","tags":[],"purpose":"transactional","inputSchema":{"schemaVersion":1,"fields":[{"key":"order_number","label":"Číslo objednávky","type":"text","required":true,"maxLength":80,"example":"TEST-100"}],"defaultSender":{"senderProfileId":"snd_00000000000000000000000000000002","replyTo":"podpora@example.test"},"engagementTracking":false},"subjectTemplate":"Objednávka {{order_number}}","previewTextTemplate":"Potvrzení objednávky","textTemplate":"Objednávka {{order_number}} byla přijata.","document":{"schemaVersion":1,"settings":{"accentColor":"#178f5d","backgroundColor":"#f4f7f5","contentColor":"#ffffff","contentWidth":640,"textColor":"#17352a"},"blocks":[{"id":"order_example","type":"text","text":"Objednávka {{order_number}} byla přijata.","tone":"default"}]}}'
Vlastní HTML používá v dokumentu schemaVersion: 3 a řetězec html (nejvýše 200 000 bajtů UTF-8). Povinné settings zůstává stejné; blocks obsahuje jediný blok spacer, bez propojených sekcí. HTML se nepřevádí na bloky a kontroluje se pravidly v2 v pohledu prohlížeče i Outlooku: projdou podmíněné komentáře a tabulky jen pro Outlook, tlačítka a pozadí ve VML, obrázek na pozadí přes CSS url(https://…) a atribut background, odkazy http: a značka s náhradní hodnotou {{first_name|"zákazníku"}}. Server odmítá aktivní obsah (skripty, formuláře, obsluhy událostí), relativní adresy obrázků a neznámé značky; publikace transakční šablony navíc odmítne odkaz na doménu NG e-mailingu. Odmítnutí uvede v fields konkrétní pole a důvod, u pravidla HTML s číslem řádku. Vykreslená zpráva včetně přepsaných měřených odkazů smí mít nejvýše 250 000 bajtů; pro Gmail držte hotový e-mail pod 102 kB. Ostatní pravidla šablon, revizí a oprávnění platí beze změny.
Transakční zpráva a dávka
Nejdříve publikujte transakční revizi a zvolte připravený odesílací profil vlastního projektu. sender_profile_id je nepovinné: když ho vynecháte, použije se výchozí odesílací profil publikované revize šablony (a její replyTo); šablona bez výchozího odesílatele vrátí 422 transactional_sender_required. Zadáte-li odesílatele výslovně, má přednost a projde stejnou kontrolou (projekt, ověřená doména, připravenost odesílání). Bez template_version se při prvním přijetí zmrazí nejnovější publikovaná revize; po publikaci nové verze ji proto další požadavky bez čísla verze dostanou automaticky. Doporučujeme posílat pevnou template_version (výběr verze šablony). 202 Accepted vrací obálku {mode, simulated, request_id, result}; v result jsou batch_id, vybraná verze a položky s message_id. Přijetí nepotvrzuje odeslání ani doručení. Testovací klíč neuloží odesílací práci. Vadné pole odmítne celou dávku; chráněný příjemce dostane položkový důvod a ostatní platné položky pokračují.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/transactional/messages' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: transactional-message-example-0001' \
--data '{"template_id":"tpl_00000000000000000000000000000001","email":"recipient@example.test","reference":"TEST-100","inputs":{"order_number":"TEST-100"}}'
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/transactional/batches' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: transactional-batch-example-0001' \
--data '{"template_id":"tpl_00000000000000000000000000000001","sender_profile_id":"snd_00000000000000000000000000000002","recipients":[{"email":"recipient@example.test","reference":"TEST-101","inputs":{"order_number":"TEST-101"}},{"email":"another@example.test","reference":"TEST-102","inputs":{"order_number":"TEST-102"}}]}'
Seznamy položek
Když má jedna zpráva obsahovat víc údajů stejného druhu, například pojištěné osoby na jedné smlouvě a ke každé odkaz na její kartičku, použijte seznam položek. Seznam se definuje v aplikaci v Nastavení → Vlastní pole → Seznamy položek a transakční šablona ho vybere; v API ho poznáte podle názvu (key). V požadavku je hodnotou seznamu v inputs pole objektů: jeden objekt je jedna položka s jejími údaji. Jeden záznam pošlete jako seznam s jednou položkou. Funguje to stejně u POST /transactional/messages i u každého příjemce POST /transactional/batches, ostatní části požadavku se nemění.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/transactional/messages' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: transactional-list-example-0001' \
--data '{"template_id":"tpl_00000000000000000000000000000001","template_version":3,"email":"recipient@example.test","reference":"ZPR-123","inputs":{"cislo_smlouvy":"S-9","pojistene_osoby":[{"jmeno":"Jan Novák","karticka_url":"https://www.example.test/k/001"},{"jmeno":"Eva Nováková","karticka_url":"https://www.example.test/k/002"}]}}'
Deklarace. GET /projects/{projectId}/transactional/templates/{templateId}/versions/{version} i katalog vracejí seznamy v input_schema.lists, vedle běžných polí v input_schema.fields. Seznam má key, label, required, nepovinné minRows a maxRows a v items údaje položky se stejnými vlastnostmi jako běžné pole (key, type, required, meze, povolené hodnoty, příklad). used_variables uvádí i značky údajů položek a request_fields.lists odkazuje na input_schema.lists. Náhled POST /projects/{projectId}/templates/{templateId}/versions/{version}/preview s tělem {"inputs": …} hodnoty ověří a vykreslí zprávu se skutečným počtem položek, nic neodešle.
Hodnoty. Údaj typu text je neprázdný řetězec bez řídicích znaků v deklarované délce, případně jedna z povolených hodnot; number je číslo JSON (ne řetězec), boolean je true nebo false, date je řetězec RRRR-MM-DD, url je HTTPS adresa bez přihlašovacích údajů a email e-mailová adresa. Povinný údaj musí mít každá položka. Nepovinný údaj, který nemáte, můžete vynechat nebo poslat jako null či prázdný řetězec: všechny tři znamenají nevyplněno a místo hodnoty bude ve zprávě prázdné místo. U povinného údaje vrátí null i prázdný řetězec chybu „Povinný údaj položky chybí.“ Totéž platí pro běžná pole v inputs a pro nepovinný seznam (null = bez položek). Text jen z mezer prázdná hodnota není a API ho odmítne. Neznámý údaj API odmítne. Položky se vykreslí v pořadí, v jakém je pošlete. Povinný seznam musí mít aspoň jednu položku, případně minRows. Nepovinný seznam smíte vynechat a opakovaná část se pak nevykreslí; prázdné pole [] projde jen u seznamu bez minRows.
Limity. Šablona má nejvýše 8 seznamů, seznam nejvýše 50 položek (nebo méně podle maxRows) a položka nejvýše 16 údajů. Údaj nesmí být další seznam ani objekt. Celý požadavek má nejvýše 1 MiB. Vykreslená zpráva má dva stropy: textová verze nejvýše 20 000 bajtů a hotové HTML po doplnění hodnot nejvýše 200 000 bajtů. U seznamu položek narazíte nejdřív na textovou verzi (například 50 položek po 16 údajích zhruba po 23 znacích). Delší zprávu API odmítne s 422 transactional_inputs_invalid u /inputs a větou, která překročený limit i skutečnou velikost jmenuje. Jméno a odkaz na kartičku pro 50 osob se vejdou s velkou rezervou.
Chyby. Vadná hodnota vrátí 422 transactional_inputs_invalid s cestou k místu chyby ve fields. Index položky začíná nulou: /inputs/pojistene_osoby/1/karticka_url je druhá položka, u dávky /recipients/0/inputs/pojistene_osoby/1/karticka_url. Chybějící povinný seznam a počet položek mimo meze hlásí cestu k seznamu, /inputs/pojistene_osoby. Stejný kód a jedinou cestu mají i chyby tvaru: víc než 50 položek (/inputs/pojistene_osoby: „Seznam smí mít nejvýše 50 položek.“), víc než 16 údajů (/inputs/pojistene_osoby/0), položka, která není objekt, a seznam nebo objekt uvnitř údaje (/inputs/pojistene_osoby/0/jmeno). Chyba u kteréhokoli příjemce odmítne celou dávku a nic se nezaloží.
{
"type": "urn:ngemailing:problem:transactional_inputs_invalid",
"title": "Zkontrolujte hodnoty příjemce.",
"status": 422,
"code": "transactional_inputs_invalid",
"request_id": "req_00000000000000000000000000000001",
"fields": {
"/inputs/pojistene_osoby/1/karticka_url": "Použijte HTTPS adresu bez přihlašovacích údajů."
}
}
Šablona. Opakování zatím funguje v šablonách s vlastním HTML. Opakovanou část ohraničí komentáře <!--ng:each pojistene_osoby--> a <!--/ng:each-->, uvnitř platí značky údajů položky a také běžná pole šablony. Komentář smí stát i mezi řádky tabulky. Opakované části se nevnořují a stejný seznam jde použít na víc místech. Hodnoty se vkládají jako text, HTML z hodnot se neprovede. Textová verze zprávy se u šablony s opakovanou částí vytvoří z vykresleného HTML, takže má stejné položky: každý řádek tabulky na vlastním řádku, buňky oddělené mezerou a za odkazem jeho adresa v závorce. Vlastní textová verze šablony se v tom případě nepoužije.
<table><tbody>
<!--ng:each pojistene_osoby-->
<tr><td>{{jmeno}}</td><td><a href="{{karticka_url}}">Stáhnout kartičku</a></td></tr>
<!--/ng:each-->
</tbody></table>
Změna seznamu. Seznam je součástí neměnné publikované verze šablony. Seznam, který používá publikovaná šablona, jde v aplikaci upravit jen tak, aby dosavadní volání fungovala dál: popisek, příklad, nový nepovinný údaj, vyšší maxRows nebo volnější meze. Jinou změnu aplikace odmítne a nabídne kopii seznamu pod novým názvem. Do API se úprava dostane až novou publikovanou verzí šablony; dosavadní template_version přijímá původní podobu a nový údaj v ní odmítne jako neznámý. Když projekt nedovoluje přepsat publikovanou šablonu, nová podoba vznikne v kopii šablony s novým template_id. Po změně proto načtěte deklaraci a upravte template_version, případně template_id.
Katalog šablon a obecné údaje požadavku
Katalog i deklarace vracejí description, purpose: transactional a used_variables. V katalogu seznam značek odpovídá current_published_version; v deklaraci konkrétní požadované verzi. name a description jsou aktuální vlastnosti knihovny, obsah a značky pocházejí z přesné publikované revize. Použité značky nezaměňujte s nepoužitými deklarovanými poli.
GET /transactional/templates (oprávnění templates:read) vrací jen publikované transakční šablony: nejnovější publikovanou verzi s jejím číslem (current_published_version.version) a deklarací vstupních polí (klíč, název, typ, povinnost, omezení) a seznamů položek v input_schema.lists (seznamy položek). Pro pravidelnou synchronizaci použijte changed_since. GET /transactional/templates/{templateId}/versions/{version} deklaruje jednu publikovanou verzi a uvádí, zda je aktuální. Aktuální je ta, kterou dostane požadavek bez template_version; integrace může pevnou verzi zadat výslovně (výběr verze šablony).
Obecné údaje požadavku jsou template_id, volitelná template_version, sender_profile_id, email, reference a hlavička Idempotency-Key. Personalizační pole patří výhradně do objektu inputs. Volitelná external_customer_id a external_contract_id (do 160 znaků) slouží k dohledání zpráv přesnou shodou ve výpisu a statistikách; nejsou klíčem zprávy, takže na stejnou adresu lze v jedné dávce poslat víc zpráv k různým smlouvám.
Převzaté sdílené šablony se v cílovém projektu objeví v témže transakčním katalogu. Mají stejné template_id, nepovinné shared_from s project_id a share_id a pouze přesně převzatou publikovanou verzi. Bez template_version se vybere tato verze; nová kopie ve zdroji ji nezmění. sender_profile_id vynechte: použije se odesílatel a Reply-To zvolený při převzetí v cíli, nikoli profil zdroje. Jiný profil vrátí 422 transactional_sender_unavailable. Samotné sdílení bez převzetí katalog ani odesílání nezpřístupní. Dokud se nedokončí kopie obrázků do cíle, přijetí vrací 422 transactional_template_unpublished; po dokončení se použijí kopie a mediální adresa cíle. Katalogová deklarace a náhled vstupů přes POST fungují i pro převzatou verzi; editační operace běžné knihovny zůstávají jen pro vlastní šablony.
Platí do
Požadavek i dávka mohou mít expires_at: nejméně 60 sekund v budoucnu a nejvýše lhůta čekání integrace (capacity.limits.queue_expiry_seconds, výchozí 24 hodin); jinak 422 transactional_expiry_invalid. Bez hodnoty platí nejdelší lhůta. Zpráva, která do té doby nebyla předána k odeslání, se neodešle: má stav cancelled a důvod transactional_queue_expired ve výsledku, událostech i webhooku. Těsně před předáním Amazon SES se platnost ověří znovu.
Načítání výsledků
Načítejte GET /transactional/messages/{messageId} a GET /transactional/batches/{batchId}. Výpis GET /transactional/messages a souhrn GET /transactional/statistics sdílejí filtry from (včetně), to (mimo), state, delivery (not_reported, delayed, delivered, bounced), engagement (clicked, opened, not_measured; bez rozpoznaných robotů), batch_id, template_id, přesnou adresu recipient a přesnou reference. Výsledky patří pouze přihlášené integraci a jejímu režimu. Souhrn počítá unikátní zachované zprávy, nikoli opakované události SES. Pole progress uvádí skutečná předání ve výběru za posledních 300 sekund, pětiminutový průměr za minutu a samostatný orientační estimated_seconds odbavení zbývající fronty. Odhad používá rozestupy alespoň tří předání z poslední minuty rozložených přes nejméně 10 sekund, poslední nejvýše 30 sekund staré. Při nedostatečném nebo zastaveném vzorku, pozastavení, drženém či rušeném požadavku, zprávách vyžadujících pozornost nebo prázdné frontě je null; není příslibem doručení. paused_messages počítá čekající zprávy pozastavených požadavků a referencí. average_handover_seconds je průměrná doba od přijetí po předání u zpráv předaných za posledních 300 sekund; bez předání je null.
Stavy: queued Ve frontě, sending Odesílá se, sent Odesláno, requires_attention Vyžaduje pozornost, cancelled Zrušeno. Doručení delivery a stížnost complaint jsou samostatné. sent může mít pozdější oznámení o nedoručení či stížnost; neznamená Doručeno. Měření je volitelné a ve výchozím stavu vypnuté. engagement: not_measured znamená Neměřeno; při aktivním měření na ověřené klientské doméně vrací API engagement: measured a engagement_counts s počty otevření a prokliků, včetně oddělených strojových událostí. Měření nepotvrzuje doručení. Detail obsahuje pokusy a časovou osu ověřených událostí, nikoli personalizační vstupy. detail_expires_at uvádí skutečnou lhůtu detailu; známý zachovaný expirovaný objekt vrátí 410 transactional_detail_expired, po fyzickém výmazu 404. Tato lhůta je nezávislá na 7/90denní ochraně opakování požadavku.
curl 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/transactional/messages?reference=TEST-100&limit=20' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY"
Průběžné události
GET /transactional/events?limit=50 vrací události a neprůhledný šifrovaný next_cursor; jeho obsah nečtěte ani neskládejte. Další požadavek použije cursor beze změny; kurzor nelze přenést na jinou integraci, projekt ani režim. Ukládejte si event_id a podle něj deduplikujte opakované čtení. Navazující čtení zachovává i události potvrzené během stránkování. Události ani kurzor nejsou určeny pro neomezený archiv: lhůta je 7 dnů; při expiraci či odstraněné historii vrací API 410 event_cursor_expired. Začněte nové čtení a použijte zachované výsledky zpráv k dorovnání evidence. Pokud byl detail zprávy vymazán, událost výslovně uvede data_available: false a reference: null. Událost neobsahuje adresu, vstupy šablony ani citlivé odkazy. Při zapnutém měření šablony přicházejí i transactional.opened a transactional.clicked; pole reason nese odhad původce (human_confirmed, machine_probable pro robota nebo ochranu soukromí, unknown). Otevření ani proklik nepotvrzují doručení ani stažení obsahu. U transactional.bounced nese reason typ vrácení: permanent (adresa neexistuje, NG ji zablokuje) nebo transient (dočasný problém, například plná schránka). Automatická odpověď (například „mimo kancelář“), kterou poskytovatel hlásí jako neurčené vrácení, událost vrácení nevytvoří; zpráva zůstává doručená. transactional.sending_state přijde jen při změně viditelného stavu; requires_attention se opakuje, když se změní důvod.
Webhooky
Oprávnění webhooks:read a webhooks:write. Integrace má nejvýše pět HTTPS cílů. Při vytvoření a rotaci se whsec_… zobrazí jednou; opakování se stejným Idempotency-Key vrátí původní cíl s secret: null a replayed: true. Po ztrátě tajemství proveďte rotaci, nevytvářejte druhý cíl. Testovací klíč simuluje nastavení a test bez skutečného webhooku.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/webhooks' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: webhook-example-0001' \
--data '{"name":"Objednávky","url":"https://shop.example.test/webhooks/email","event_types":["transactional.sending_state","transactional.delivered","transactional.bounced","transactional.complained"],"enabled":true}'
PATCH /webhooks/{webhookId} vyžaduje celé nastavení a expected_version; souběžná změna vrátí 409. POST /webhooks/{webhookId}/rotate-secret také vyžaduje expected_version. URL, výběr událostí a tajemství se připnou k verzi platné pro čas potvrzení události. Historie nadále používá původní URL a tajemství; API nepřesouvá historii na nový server. Původní tajemství přijímejte po celou sedmidenní lhůtu zachovaných doručení. POST /webhooks/{webhookId}/archive s expected_version a confirm_archive:true nevratně uvolní kapacitu cíle a zastaví čekající pokusy. Již zahájený pokus může dokončit předání; historie je dostupná do vlastní expirace. Archivovaný cíl nelze znovu zapnout. Vypnutí cíle drží rozpracované pokusy; události potvrzené během vypnutí se nedoručují.
Služba podepíše přesné UTF-8 tělo pomocí HMAC-SHA256 přes timestamp + "." + rawBody, kde timestamp je celé UNIX datum v sekundách. Hlavičky jsou X-NG-Webhook-Timestamp, X-NG-Webhook-Signature: v1=hex, X-NG-Event-Id a X-NG-Delivery-Id. Klíč pro HMAC je 32 bajtů získaných base64url dekódováním části za whsec_. Ověřte podpis před parsováním, přijímejte čas nejvýše ±300 sekund od aktuálního času a trvale deduplikujte podle podepsaného event_id v těle. Události mohou přijít duplicitně a mimo pořadí; pořadí webhooku nepotvrzuje současný stav zprávy.
Webhook neobsahuje e-mailovou adresu ani vstupy šablony. Událost má stejné ID, typ, schema_version, message_id/batch_id, čas, režim, klientskou referenci a oddělený stav jako průběžné načítání přes API. Po výmazu detailu je reference null a data_available false. Síťová kontrola při každém pokusu odmítá soukromé, loopback, metadata a vyhrazené IP adresy, smíšené DNS odpovědi a přesměrování; TLS ověřuje původní název serveru.
HTTP 2xx znamená doručeno. 408, 429, 5xx, výpadek spojení a nejistá odpověď se omezeně opakují, nejvýše šest pokusů celkem s prodlevami 30, 120, 600, 1800 a 7200 sekund. Ostatní HTTP chyby jsou konečné. DNS má lhůtu 3 sekundy, spojení neaktivní 5 sekund, celý HTTP pokus 10 sekund; tělo nejvýše 64 KiB a odpověď 16 KiB. Výchozí sdílený integrační limit je 60 pokusů/minutu; aktuální příděl ukazuje capacity.limits.webhook_attempts_per_minute. Provozovatel může přidělit méně než šest pokusů; každé přijaté doručení si svůj limit zachová. Výpadek webhooku nikdy neposílá nový e-mail.
GET /webhooks/{webhookId}/deliveries nabízí limit 1–100 a offset do 100000; detail GET /webhooks/{webhookId}/deliveries/{deliveryId} obsahuje jednotlivé pokusy a původní URL bez tajemství/těla. Pokusy a šifrovaná těla mají výchozí lhůtu 7 dnů, přidělit lze 1–7 dnů a konkrétní expires_at platí pro přijaté doručení; zachovaný expirovaný detail vrací 410, po fyzickém výmazu 404. POST /webhooks/{webhookId}/test s confirm_test:true zařadí syntetickou událost webhook.test bez e-mailu. Opakování dokončeného doručení přes POST /webhooks/{webhookId}/deliveries/{deliveryId}/retry vyžaduje expected_attempt, confirm_repeat:true a nový Idempotency-Key; stále používá původní event_id, URL a původní přidělený limit pokusů.
Marketingovou kampaň lze naplánovat přes její dispatch-requests. Změna termínu používá POST /campaigns/{campaignId}/dispatch-requests/{dispatchRequestId}/reschedule s scheduledAt a spreadOverHours. Povolena je pouze dosud nezahájená čekající práce; vzniká neměnný následník nad stejnými schválenými podklady, bez nového příjemce či obejití podmínky odesílání.
Účinné blokace
Oprávnění suppressions:read nabízí GET /suppressions s limit/offset a volitelnou přesnou adresou recipient. Výpis propojuje kontaktní blokace a minimální nezávislou ochranu po trvalém nedoručení nebo stížnosti, která přežije odstranění kontaktu a zprávy. Neobsahuje adresy ani HMAC otisky; count_basis:evidence_records uvádí počet evidencí, který není počtem unikátních adres. Zdroj, důvod, chráněnost, účinek na marketing/transakci a dostupná lhůta jsou explicitní. Výpis obsahuje i registr adres (source: registry): dočasné blokace, zákazy Amazon SES, ruční blokace a blokace adres mimo Kontakty. Trvalé nedoručení, stížnost a zákaz SES platí v celé organizaci, tedy i v jejích ostatních projektech; odhlášení z odběru blokací není. POST /suppressions/check s tělem {"recipient":"…"} vrátí účinné důvody pro konkrétní adresu (zastaralá varianta GET /suppressions/check?recipient=… dává stejný výsledek, ale adresa v URL může zůstat v přístupových lozích), včetně ochrany bez marketingového kontaktu a blokací z registru adres (například dočasná blokace po plné schránce soft_bounce, zákaz Amazon SES nebo ruční blokace); shoduje se s tím, co odmítne přijetí transakce. Absence blokace nepovoluje marketing: permission_checked:false znamená, že je nadále nutný doložený souhlas a všechny podmínky odesílání. API neposkytuje odstranění ani obcházení chráněné blokace.
Koncept kampaně
Vytvoření konceptu nic neodesílá. Před zařazením použijte připravenost, neměnné podklady a stávající schvalovací postup. ID odběru musí patřit vašemu projektu.
Pokud GET /campaigns/{campaignId}/readiness vrací reviewPackage: null, podklad ještě nebyl dokončen nebo neodpovídá aktuálnímu obsahu a publiku. V běžném režimu zavolejte POST /campaigns/{campaignId}/finalize-standard-preparation bez těla, s oprávněním campaigns:write a novým Idempotency-Key. Je to stejná akce jako Dokončit přípravu v aplikaci: vytvoří neměnný obsah, balíček a interní potvrzení bez návštěvy aplikace. Odpověď je obal zápisu: podklad čtěte z result.reviewPackage.id. Pokud zůstává null, result.nextAction a result.checks vysvětlí nutnou opravu nebo čekání na publikum; HTTP 200 samo neznamená dokončenou přípravu. Po opravě použijte nový klíč požadavku, protože opakování starého vrací původní výsledek.
Poté načtěte GET /campaigns/{campaignId}/delivery-readiness a pro POST /campaigns/{campaignId}/dispatch-requests použijte aktuální expectedSourceInputHash z pole sourceInputHash a expectedReviewPackageId z dokončeného podkladu. Hash je řetězec 64 malých šestnáctkových znaků; nevymýšlejte ho ani nepočítejte sami. Pokud je sourceInputHash: null nebo canCreatePlan: false, nejprve vyřešte checks a odeslání nevolejte. Null, prázdný řetězec nebo nedosazená proměnná v expectedSourceInputHash vrátí 422 validation_error s polem /expectedSourceInputHash. Příprava sama nic neodesílá ani neplánuje; ostatní podmínky odeslání zůstávají povinné. Přísný režim vrací 409 campaign_standard_preparation_mode_required a dál vyžaduje rozhodnutí druhé osoby. Testovací klíč přípravu jen simuluje: vrácené nové ID se neuloží a není použitelné pro další zápis.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/campaigns' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: campaign-example-0001' \
--data '{"name":"Ukázková kampaň","audience":{"mode":"all_production_email","subscriptionTypeId":"sub_00000000000000000000000000000001"}}'
Koncept automatizace
Použijte existující segment a verzi šablony vlastního projektu. Koncept ani validace nic neodesílají.
PUT /automations/{workflowId} založí novou revizi jen při změně kroků (segment, šablona, čekání). Změna jen názvu nebo poznámky se uloží bez nové revize: currentVersion v odpovědi zůstane stejné. Do dalšího požadavku proto vždy pošlete expectedVersion z poslední odpovědi, nepočítejte ho sami.
curl -X POST 'https://my.ngemailing.cz/api/integrations/v1/projects/prj_00000000000000000000000000000001/automations' \
-H 'Authorization: Bearer '"$NG_TEST_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: automation-example-0001' \
--data '{"name":"Ukázková automatizace","segmentId":"seg_00000000000000000000000000000001","segmentVersion":1,"emailTemplateId":"tpl_00000000000000000000000000000001","emailTemplateVersion":1,"waitDays":1}'
Skupina je statické členství; odběr je samostatný doložený stav a segment je dynamická podmínka. Vytvoření skupiny nikdy nepřihlašuje k odběru. Odstranění kontaktu neodstraní chráněnou blokaci.