Docs

APIPočetak

Greške

Format grešaka, šta znači svaki status i kad zahtjev ponoviti.

Greške se vraćaju kao application/problem+json (RFC 9457) sa stabilnom šifrom u code. Granajte kod po code, ne po tekstu u detail — tekst se može poboljšati, šifra ostaje.

400 invalid_request
{
  "type": "https://api.cifra.ba/errors/invalid_request",
  "title": "Bad Request",
  "status": 400,
  "code": "invalid_request",
  "detail": "The request does not match the schema.",
  "request_id": "033ce4b4-d930-4b5a-9cf9-6b2b006ac473",
  "errors": [
    {
      "path": "year",
      "message": "year is in the future",
      "code": "custom"
    },
    {
      "path": "mileage_km",
      "message": "Too small: expected number to be >=0",
      "code": "too_small"
    },
    {
      "path": "doors",
      "message": "doors applies to car only, not motorcycle",
      "code": "custom"
    }
  ]
}

Statusi

StatusZnačenjePonoviti?
400Zahtjev nije ispravan: polja, JSON, parametri.Ne, ispravite zahtjev
401Nema ključa, nepoznat ili istekao.Ne
403Ključ ne smije ovo: pristup, IP adresa, pauza.Ne
404Ne postoji (ili je druge kompanije ili okruženja).Ne
409Sukob sa stanjem: pun limit praćenja, isključena adresa.Ne, promijenite stanje
413Prevelik zahtjev ili lista.Ne, podijelite
422Ispravan oblik, ali nemoguć sadržaj: nepoznata marka, datum u budućnosti.Ne
429Limit u minuti ili mjesečna kvota.Da, nakon Retry-After (osim kvote)
5xxGreška kod nas.Da, s eksponencijalnim čekanjem

Greške u listama

Masovna procjena i uvoz portfelja ne padaju zbog jednog vozila: odgovor je 200, a svako vozilo ima ili rezultat ili error na svom mjestu (index). Naplaćuju se samo uspjeli.

Stavka s greškom
{
  "index": 2,
  "error": {
    "code": "unknown_model",
    "detail": "Unknown model \"pasat\" for Volkswagen. See GET /v1/taxonomy/makes/volkswagen/models."
  }
}

Upozorenja nisu greške

Procjena može uspjeti i nositi warnings: npr. nedostaju podaci pa je raspon širi. Prikažite ih ili zabilježite; nepoznatu šifru upozorenja tretirajte kao informaciju. Sva upozorenja: Tržišna vrijednost.

Sve šifre

Potpuna lista sa statusom, uzrokom i rješenjem: Šifre grešaka.

Česte greške

StatusŠifraKadŠta uraditi
400invalid_bodyTijelo nije JSON.Pošaljite Content-Type: application/json i ispravan JSON.
401missing_tokenZahtjev nema ključ.Pošaljite Authorization: Bearer cfr_live_… (ili x-api-key).
401invalid_tokenKljuč ne postoji, opozvan je ili nije dobrog oblika.Provjerite da šaljete cijeli ključ, bez razmaka; napravite novi u Razvoj → API ključevi.
401token_expiredKljuču je prošao datum isteka.Napravite novi ključ ili produžite postojeći na platformi.
403key_pausedVaša kompanija je pauzirala ključ.Administrator ga nastavlja u Razvoj → API ključevi.
403token_suspendedCifra je privremeno zaustavila ključ.Javite se podršci.
403ip_not_allowedKljuč prima zahtjeve samo s dozvoljenih adresa, a ova nije među njima (odgovor nosi ip).Dodajte adresu ili CIDR raspon ključu na platformi.
403insufficient_scopeKljuč nema pristup ovoj usluzi (npr. Provjera vozila bez listings).Dodajte pristup ključu ili koristite drugi ključ.
413payload_too_largeTijelo je veće od 2 MB.Podijelite listu na manje zahtjeve.
429rate_limitedPreviše zahtjeva u minuti.Sačekajte Retry-After sekundi i ponovite; ravnomjerno raspodijelite zahtjeve.
429quota_exceededPotrošena mjesečna kvota ugovora (odgovor nosi quota, used, resets_at).Kvota se obnavlja 1. u mjesecu (UTC); za veću se javite prodaji.
429key_limit_reachedKljuč je potrošio mjesečni limit koji mu je postavila vaša kompanija (limit, used, resets_at).Administrator povećava limit ključa na platformi.
500internal_errorGreška na strani Cifre.Ponovite zahtjev; ako se ponavlja, pošaljite request_id podršci.