Hibák
Minden hibának ugyanaz a borítéka: { "error": "<code>", "message": "…", "details": { … } }. Az error alapján ágazz el, soha ne a message alapján; a details.path megnevezi a mezőt, ha egy mező a hibás.
Az elérési utak, mezőnevek, hibakódok, fejlécnevek és kódpéldák angolul maradnak: ezek jelentik a szerződést.
Mikor próbáld újra
A 429 és a 503 Retry-After fejléccel érkezik: várj ennyi másodpercet, majd küldd el újra ugyanazt a kérést. A 504 solve_timeout kisebb feladattal újrapróbálva sikerülhet. Minden 429-től eltérő 4xx maga a kérés hibája, és változatlanul újra elbukik.
Hibakódok
| Hibakód | HTTP-státusz | Jelentés |
|---|---|---|
| invalid_request | 400 | A törzs vagy egy paraméter hibás: nem JSON, nem objektum, vagy egy mező alakja rossz. |
| idempotency_key_required | 400 | A rendelési hívásból hiányzik az érvényes Idempotency-Key fejléc. |
| quote_invalid | 400 | Az ajánlattoken nem ehhez az ajánlathoz tartozik, lejárt vagy módosították, vagy a teszt és az éles keveredett. |
| unknown_workflow | 400 | A webshopnak nincs ilyen azonosítójú munkafolyamata. |
| workflow_disabled | 400 | A munkafolyamat létezik, de ki van kapcsolva. |
| mode_mismatch | 400 | A küldött mód nem ennek a munkafolyamatnak a módja. |
| unknown_mode | 400 | A küldött mód nem ismert mód. |
| unsupported_mode | 400 | A munkafolyamat módja ezen a szolgáltatáson még nem érhető el. |
| limit_exceeded | 400 | Túl sok vagy túl kevés sor, túl sok alkatrész, vagy a webshop méretkorlátain kívül eső alkatrész. |
| outside_catalog_slice | 400 | Egy anyag nem szerepel ebben a munkafolyamatban. |
| unknown_reference | 400 | Egy anyag, élzáró vagy más katalóguselem ismeretlen vagy ki van kapcsolva. |
| required_field_missing | 400 | Egy, a webshop által kötelezőnek jelölt mező hiányzik. |
| unauthorized | 401 | A kulcs hiányzik, hibás, ismeretlen vagy visszavont, esetleg egy teszt kulcs lejárt. |
| project_token_required | 401 | A projekthíváshoz kell a projekttoken fejléc. |
| project_token_invalid | 401 | A projekttoken fejléc hibás, vagy kétszer lett elküldve. |
| quota_exceeded | 402 | A webshop havi ajánlatkerete elfogyott. |
| customer_context_required | 403 | Az alapértelmezettől eltérő vevőcsoporthoz a titkos kulcs kell, vagyis a szervered hívása. |
| origin_not_allowed | 403 | Az oldal origin-je nincs rajta a publikus kulcs listáján. |
| sandbox_expired | 403 | A sandbox webshop lejárt, és csak olvasható. |
| not_found | 404 | Nincs ilyen útvonal, ajánlat, rendelés vagy projekt, vagy egy másik webshophoz tartozik. |
| not_configured | 404 | A webshop még nem tett közzé konfigurációt. |
| idempotency_conflict | 409 | Ezt az Idempotency-Key értéket már használták egy másik ajánlathoz. |
| quote_already_redeemed | 409 | Ezt az ajánlatot már megrendelték. |
| quote_requote | 409 | Az ajánlatot egy azóta lecserélt kulccsal írták alá: kérj új ajánlatot. |
| too_large | 413 | A kérés törzse nagyobb, mint amit az útvonal elfogad. |
| unsupported_media_type | 415 | A törzset nem application/json formában küldték. |
| plan_incomplete | 400 / 422 | Néhány alkatrész egyetlen lapra sem fér el, ezért nincs mit árazni. |
| project_not_reorderable | 422 | A mentett projekt nem tartalmaz árazható szabásjegyzéket. |
| rate_limited | 429 | Elérted a kéréskorlátot: várj a Retry-After fejlécben megadott másodpercig. |
| busy | 429 | A solver sora megtelt: próbáld újra a Retry-After fejlécben megadott másodperc után. |
| test_limit | 429 | A teszt kulcsok elérték a napi ajánlat- vagy rendeléskorlátjukat. |
| sandbox_order_limit | 429 | A sandbox webshop elérte az időszakra szóló rendelési felső határát. |
| project_limit | 429 | A webshop már a mentett projektek legnagyobb számát vagy méretét tárolja. |
| internal | 500 | Váratlan hiba a mi oldalunkon. |
| service_unavailable | 503 | A szolgáltatás egy része nem válaszolt: próbáld újra később. |
| config_invalid | 503 | A webshop konfigurációja nem tölthető be. |
| tenant_unconfigured | 503 | A webshopnak nincs aktív ajánlat-aláíró kulcsa. |
| final_engine_unavailable | 503 | Ez a munkafolyamat a max motoron árazna, amely itt nem érhető el. |
| solve_timeout | 504 | A terv elkészítése túl sokáig tartott. |
Árazási kódok
Ezek a kódok az árazómotortól jönnek. A POST /cfg/v1/quote hívásra és az újrarendelésre 400-zal válaszolnak; a POST /cfg/v1/preview hívás sikeres, és a kód a priceError mezőben érkezik, így az élő előnézet meg tudja mutatni a tervet akkor is, ha az ár nem számítható ki.
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
Szándékosan nincs itt "kipróbálom" gomb: a titkos kulcs a szerveredre való, soha nem a böngészőbe. A demó webshop elejétől végéig megmutatja a beágyazást és a rendelés átadását.
Jogi tudnivalókKonfigurátor feltételek (EN) ·Adatfeldolgozási szerződés (EN) ·Vásárlói adatvédelmi tájékoztató ·Harmadik féltől származó licencek (EN)