Greške

Neuspješni zahtjevi vraćaju JSON (ne prazno tijelo). Uobičajeni oblik:

{
  "error": "invalid_credentials",
  "message": "Invalid email or password"
}

Neuspješna validacija može uključivati i polje details iz Zoda. error tretirajte kao stabilan strojni kod, a message kao poruku za čitanje (neke poruke prema kupcu su na hrvatskom).

HTTP statusi

Status Značenje
400 Validacija ili loš unos
401 Nedostaje/neispravan token ili neuspješna prijava
403 Autentificiran, ali nema pravo (uloga, paket, suspendiran)
404 Resurs ne postoji ili nije vlasništvo pozivatelja
409 Sukob (dupli e-mail, GTIN, naziv foldera, adresa pošiljatelja)
429 Prekoračen limit zahtjeva
500 / 502 / 503 Pad uzvodnog servisa ili konfiguracije (e-mail, OCR, mint, pohrana)

Česti error kodovi

error Tipični HTTP Napomena
unauthorized 401 Nedostaje, neispravan ili neprovjeriv JWT
forbidden 403 Uloga ili pretplatni paket ne dopuštaju radnju
invalid_credentials 401 Prijava nije uspjela
account_suspended 403 Korisnik je suspendiran
merchant_suspended 403 Organizacija trgovca nije ACTIVE
validation_error 400 Tijelo/upit nisu prošli shemu
not_found 404 Jamstvo, račun, folder, trgovac, proizvod ili pošiljatelj
invalid_token / expired_token / token_used 401 Životni ciklus magic linka
expired / invalid_link 401 Životni ciklus claim linka
too_many_requests 429 Ponovno slanje claim linka
email_taken 409 Admin stvara korisnika trgovca
duplicate_gtin 409 GTIN globalnog proizvoda već postoji
product_in_use 409 Globalni proizvod se ne može obrisati jer se koristi
already_registered 409 Adresa pošiljatelja trgovca
already_verified 409 Ponovno slanje verifikacije za već potvrđenog pošiljatelja
email_failed 502 Odlazna pošta nije poslana
ocr_failed 500 OCR računa nedostupan
warranty_issue_failed / retry_mint_failed 500 Cjevovod izdavanja / minta
unavailable 503 Pohrana/dijeljenje računa nije konfigurirano

Primjeri samo za trgovca: missing_merchant_id, missing_product_reference, missing_customer_identifier, product_not_found, warranty_not_found.

Interaktivna referenca

Sheme zahtjeva i odgovora za dokumentirane rute nalaze se u API referenci i OpenAPI specifikaciji. Neke novije rute (računi, inbox, adrese pošiljatelja) opisane su u ovim vodičima i kad specifikacija još zaostaje — ako se razlikuju, prednost imaju pokrenuti API i ove stranice.