Pogreške
Svaka pogreška ima isti omot: { "error": "<code>", "message": "…", "details": { … } }. Granajte prema error, nikad prema message; details.path imenuje polje kad je krivo neko polje.
Putanje, nazivi polja, kodovi pogrešaka, nazivi zaglavlja i primjeri kôda ostaju na engleskom: oni su ugovor.
Kada ponoviti
429 i 503 dolaze sa zaglavljem Retry-After: pričekajte toliko sekundi i pošaljite isti zahtjev ponovno. 504 solve_timeout može uspjeti pri ponovnom pokušaju s manjim poslom. Svaki 4xx osim 429 problem je samog zahtjeva i ponovno pada ako se ne promijeni.
Kodovi
| Kôd | Stanje | Značenje |
|---|---|---|
| invalid_request | 400 | Tijelo ili parametar je neispravan: nije JSON, nije objekt ili polje ima pogrešan oblik. |
| idempotency_key_required | 400 | Poziv narudžbe nema valjano zaglavlje Idempotency-Key. |
| quote_invalid | 400 | Token ponude ne pripada ovoj ponudi, istekao je ili je promijenjen, ili su pomiješani test i stvarni rad. |
| unknown_workflow | 400 | Web shop nema workflow s ovim id-jem. |
| workflow_disabled | 400 | Workflow postoji, ali je isključen. |
| mode_mismatch | 400 | Poslani način nije način ovog workflowa. |
| unknown_mode | 400 | Poslani način nije poznat način. |
| unsupported_mode | 400 | Način workflowa još nije dostupan u ovom servisu. |
| limit_exceeded | 400 | Previše ili premalo redaka, previše dijelova ili dio izvan ograničenja veličine web shopa. |
| outside_catalog_slice | 400 | Materijal se u ovom workflowu ne nudi. |
| unknown_reference | 400 | Materijal, kantna traka ili druga stavka kataloga nepoznata je ili isključena. |
| required_field_missing | 400 | Nedostaje polje koje je web shop označio obveznim. |
| unauthorized | 401 | Ključ nedostaje, neispravan je, nepoznat ili opozvan, ili je testni ključ istekao. |
| project_token_required | 401 | Poziv projekta zahtijeva zaglavlje s tokenom projekta. |
| project_token_invalid | 401 | Zaglavlje s tokenom projekta je neispravno ili je poslano dvaput. |
| quota_exceeded | 402 | Mjesečna kvota ponuda web shopa je potrošena. |
| customer_context_required | 403 | Grupa kupaca različita od zadane zahtijeva tajni ključ, dakle poziv s vašeg poslužitelja. |
| origin_not_allowed | 403 | Podrijetlo stranice nije na popisu javnog ključa. |
| sandbox_expired | 403 | Sandbox web shop je istekao i samo je za čitanje. |
| not_found | 404 | Ne postoji takva ruta, ponuda, narudžba ili projekt, ili pripada drugom web shopu. |
| not_configured | 404 | Web shop još nije objavio konfiguraciju. |
| idempotency_conflict | 409 | Ovaj Idempotency-Key već je upotrijebljen za drugu ponudu. |
| quote_already_redeemed | 409 | Ova ponuda je već naručena. |
| quote_requote | 409 | Ponuda je potpisana ključem koji je u međuvremenu rotiran: zatražite novu ponudu. |
| too_large | 413 | Tijelo zahtjeva veće je nego što ruta prihvaća. |
| unsupported_media_type | 415 | Tijelo nije poslano kao application/json. |
| plan_incomplete | 400 / 422 | Neki dijelovi ne stanu ni na jednu ploču, pa nema što ponuditi. |
| project_not_reorderable | 422 | Spremljeni projekt ne sadrži popis rezanja kojem se može odrediti cijena. |
| rate_limited | 429 | Dosegnuto je ograničenje učestalosti: pričekajte sekunde iz Retry-After. |
| busy | 429 | Red rješavača je pun: pokušajte ponovno nakon sekundi iz Retry-After. |
| test_limit | 429 | Testni ključevi dosegnuli su dnevnu gornju granicu ponuda ili narudžbi. |
| sandbox_order_limit | 429 | Sandbox web shop dosegnuo je gornju granicu narudžbi za razdoblje. |
| project_limit | 429 | Web shop već pohranjuje najveći broj ili veličinu spremljenih projekata. |
| internal | 500 | Neočekivana pogreška na našoj strani. |
| service_unavailable | 503 | Dio servisa nije odgovorio: pokušajte ponovno kasnije. |
| config_invalid | 503 | Konfiguraciju web shopa nije moguće učitati. |
| tenant_unconfigured | 503 | Web shop nema aktivan ključ za potpisivanje ponuda. |
| final_engine_unavailable | 503 | Ovaj workflow izrađuje ponude na max mehanizmu, koji ovdje nije dostupan. |
| solve_timeout | 504 | Plan je trajao predugo. |
Kodovi cijena
Ovi kodovi dolaze iz mehanizma za cijene. Odgovaraju 400 na POST /cfg/v1/quote i pri ponovnoj narudžbi; na POST /cfg/v1/preview poziv uspijeva, a kôd stiže u priceError, pa pregled uživo može prikazati plan iako se cijena ne može izračunati.
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
Gumba „isprobaj“ ovdje namjerno nema: tajni ključ pripada vašem poslužitelju, nikad pregledniku. Demo web shop prikazuje ugradnju i predaju narudžbe u radu od početka do kraja.
Pravne informacijeUvjeti konfiguratora (EN) ·Ugovor o obradi podataka (EN) ·Obavijest o privatnosti za kupce ·Licencije trećih strana (EN)