Chyby
Každá chyba má stejnou obálku: { "error": "<code>", "message": "…", "details": { … } }. Větvete podle error, nikdy podle message; details.path pojmenuje pole, pokud je chyba v něm.
Cesty, názvy polí, chybové kódy, názvy hlaviček a ukázky kódu zůstávají anglicky: jsou součástí kontraktu.
Kdy opakovat
429 a 503 přicházejí s hlavičkou Retry-After: počkejte tolik sekund a pošlete stejný požadavek znovu. 504 solve_timeout se při opakování s menší úlohou může podařit. Každé 4xx kromě 429 je chyba samotného požadavku a bez úpravy selže znovu.
Kódy
| Kód | Stav | Význam |
|---|---|---|
| invalid_request | 400 | Tělo nebo parametr je chybný: není JSON, není objekt, nebo má pole nesprávný tvar. |
| idempotency_key_required | 400 | Volání objednávky nemá platnou hlavičku Idempotency-Key. |
| quote_invalid | 400 | Token nabídky nepatří k této nabídce, vypršel nebo byl změněn, nebo se smíchal test s ostrým provozem. |
| unknown_workflow | 400 | Obchod nemá workflow s tímto id. |
| workflow_disabled | 400 | Workflow existuje, ale je vypnuté. |
| mode_mismatch | 400 | Odeslaný režim není režimem tohoto workflow. |
| unknown_mode | 400 | Odeslaný režim není známý režim. |
| unsupported_mode | 400 | Režim workflow zatím není v této službě dostupný. |
| limit_exceeded | 400 | Příliš mnoho nebo příliš málo řádků, příliš mnoho dílů, nebo díl mimo limity velikosti obchodu. |
| outside_catalog_slice | 400 | Materiál se v tomto workflow nenabízí. |
| unknown_reference | 400 | Materiál, hrana nebo jiná položka katalogu je neznámá nebo vypnutá. |
| required_field_missing | 400 | Chybí pole, které obchod označil jako povinné. |
| unauthorized | 401 | Klíč chybí, má špatný tvar, je neznámý nebo zrušený, nebo testovací klíč vypršel. |
| project_token_required | 401 | Volání projektu vyžaduje hlavičku s tokenem projektu. |
| project_token_invalid | 401 | Hlavička s tokenem projektu má špatný tvar nebo byla odeslána dvakrát. |
| quota_exceeded | 402 | Měsíční limit nabídek obchodu je vyčerpán. |
| customer_context_required | 403 | Jiná skupina zákazníků než výchozí vyžaduje tajný klíč, tedy volání z vašeho serveru. |
| origin_not_allowed | 403 | Origin stránky není v seznamu veřejného klíče. |
| sandbox_expired | 403 | Sandbox obchod vypršel a je jen pro čtení. |
| not_found | 404 | Taková routa, nabídka, objednávka ani projekt neexistuje, nebo patří jinému obchodu. |
| not_configured | 404 | Obchod zatím nepublikoval konfiguraci. |
| idempotency_conflict | 409 | Tento Idempotency-Key už byl použit pro jinou nabídku. |
| quote_already_redeemed | 409 | Tato nabídka už byla objednána. |
| quote_requote | 409 | Nabídka byla podepsána klíčem, který byl od té doby vyměněn: vyžádejte si novou nabídku. |
| too_large | 413 | Tělo požadavku je větší, než routa přijímá. |
| unsupported_media_type | 415 | Tělo nebylo odesláno jako application/json. |
| plan_incomplete | 400 / 422 | Některé díly se nevejdou na žádnou desku, takže není co nabídnout. |
| project_not_reorderable | 422 | Uložený projekt neobsahuje seznam dílů, který lze ocenit. |
| rate_limited | 429 | Byl dosažen limit četnosti: počkejte počet sekund z Retry-After. |
| busy | 429 | Fronta řešiče je plná: zkuste to znovu po počtu sekund z Retry-After. |
| test_limit | 429 | Testovací klíče dosáhly denního stropu nabídek nebo objednávek. |
| sandbox_order_limit | 429 | Sandbox obchod dosáhl stropu objednávek pro dané období. |
| project_limit | 429 | Obchod už ukládá maximální počet nebo velikost uložených projektů. |
| internal | 500 | Neočekávaná chyba na naší straně. |
| service_unavailable | 503 | Část služby neodpověděla: zkuste to později. |
| config_invalid | 503 | Konfiguraci obchodu nelze načíst. |
| tenant_unconfigured | 503 | Obchod nemá aktivní klíč pro podepisování nabídek. |
| final_engine_unavailable | 503 | Toto workflow počítá nabídky na enginu max, který zde není dostupný. |
| solve_timeout | 504 | Výpočet plánu trval příliš dlouho. |
Cenové kódy
Tyto kódy pocházejí z cenového enginu. Na POST /cfg/v1/quote a při opakované objednávce odpovídají 400; u POST /cfg/v1/preview volání uspěje a kód přijde v priceError, takže živý náhled může ukázat plán, i když cenu nelze spočítat.
invalid_config · invalid_job · invalid_request · unknown_workflow · workflow_disabled · unknown_mode · mode_unavailable · unsupported_mode · unknown_reference · item_disabled · outside_catalog_slice · unpriced_item · no_strategy · unpriced_sheet · cut_length_unattributable · plan_incomplete · bonded_unpriced · bonded_not_allowed · template_value_invalid · machining_length_missing · machining_invalid · unknown_customer_group · shipping_unavailable · delivery_below_minimum · weight_unavailable · rule_budget · amount_overflow
Tlačítko „vyzkoušet“ tu záměrně není: tajný klíč patří na váš server, nikdy do prohlížeče. Demo obchod ukazuje vložení i předání objednávky v provozu od začátku do konce.
Právní informacePodmínky konfigurátoru (EN) ·Smlouva o zpracování údajů (EN) ·Zásady ochrany osobních údajů pro kupující ·Licence třetích stran (EN)