API referencaOstalo
Šifre grešaka
Svaka šifra greške: HTTP status, kad se javlja i šta uraditi.
Granajte kod po code. Šifre označene kao opšte može vratiti svaki poziv s ključem; ostale samo endpointi koji ih navode. Format greške: Greške.
| Status | Šifra | Kad | Šta uraditi |
|---|---|---|---|
| 400 | invalid_request | Tijelo ili parametri ne odgovaraju šemi; errors navodi svako polje. | Ispravite polja iz errors[].path. Nepoznata polja se odbijaju. |
| 400 | invalid_body | Tijelo nije JSON. | Pošaljite Content-Type: application/json i ispravan JSON. |
| 400 | invalid_vehicle_type | vehicle_type nije car, motorcycle ni truck. | Pošaljite jednu od te tri vrijednosti. |
| 400 | invalid_webhook_url | Adresa nije HTTPS ili vodi na lokalnu ili privatnu mrežu. | Koristite javnu HTTPS adresu. |
| 401 | missing_token | Zahtjev nema ključ. | Pošaljite Authorization: Bearer cfr_live_… (ili x-api-key). |
| 401 | invalid_token | Ključ ne postoji, opozvan je ili nije dobrog oblika. | Provjerite da šaljete cijeli ključ, bez razmaka; napravite novi u Razvoj → API ključevi. |
| 401 | token_expired | Ključu je prošao datum isteka. | Napravite novi ključ ili produžite postojeći na platformi. |
| 403 | key_paused | Vaša kompanija je pauzirala ključ. | Administrator ga nastavlja u Razvoj → API ključevi. |
| 403 | token_suspended | Cifra je privremeno zaustavila ključ. | Javite se podršci. |
| 403 | company_inactive | Ugovor ili probni period kompanije kojoj ključ pripada je istekao ili je pauziran. | Javite se podršci ili vlasniku naloga kompanije. |
| 403 | api_not_included | Cifra API nije dio ugovora kompanije kojoj ključ pripada. | Javite se podršci da dodamo API u ugovor. |
| 403 | ip_not_allowed | Ključ prima zahtjeve samo s dozvoljenih adresa, a ova nije među njima (odgovor nosi ip). | Dodajte adresu ili CIDR raspon ključu na platformi. |
| 403 | insufficient_scope | Ključ nema pristup ovoj usluzi (npr. Provjera vozila bez listings). | Dodajte pristup ključu ili koristite drugi ključ. |
| 403 | organization_required | Ključ pripada klijentu koji nije vezan za kompaniju; widgeti su kompanijini. | Koristite ključ napravljen na Cifra platformi vaše kompanije (Razvoj → API ključevi). |
| 403 | live_key_required | Testni ključ: widgeti su javni i objavljuju se samo iz stvarnih procjena. | Objavite s produkcijskim ključem (cfr_live_…). |
| 404 | not_found | Ne postoji, ili pripada drugoj kompaniji ili drugom okruženju. | Provjerite oznaku i da koristite ključ istog okruženja (live/test). |
| 404 | valuation_not_found | Procjena ne postoji ili nije napravljena ključem vaše kompanije. | Pošaljite id iz odgovora POST /v1/valuations napravljenog vašim produkcijskim ključem. |
| 404 | listing_not_found | Cifra još nije vidjela oglas: nov je (stranice se pregledaju dnevno) ili je sa stranice koju ne pratimo. | Pokušajte sutra; pratimo olx.ba, autobum.ba i autoplac.ba. |
| 409 | pinned_model_unavailable | Ključ je vezan za verziju modela koja trenutno ne radi za ovu vrstu vozila. | Javite se podršci da ključ vežu za drugu verziju. |
| 409 | duplicate_external_ref | Vaša oznaka je već na drugom widgetu. | Izmijenite postojeći widget (PATCH) ili ga uklonite; oznaka je jedinstvena među živim widgetima. |
| 409 | widget_limit_reached | Objavljeno je onoliko vozila koliko plan dozvoljava (pauzirana se broje, prodana ne). | Uklonite vozila koja više ne prodajete ili pređite na veći plan. Odgovor nosi limit i used. |
| 409 | watchlist_full | Dostignut broj praćenih vozila plana (odgovor nosi max, count). | Uklonite vozila koja više ne trebate ili povećajte plan. |
| 409 | too_many_webhooks | Već 5 aktivnih adresa u ovom okruženju. | Isključite adresu koju ne koristite. |
| 409 | webhook_disabled | Adresa je isključena. | Dodajte je ponovo ili je uključite na platformi. |
| 413 | payload_too_large | Tijelo je veće od 2 MB. | Podijelite listu na manje zahtjeve. |
| 413 | batch_too_large | Više vozila nego što plan dozvoljava u jednom pozivu. | Podijelite listu na dijelove od najviše batch_max_items. |
| 422 | unknown_make | Marka nije u šifarniku (odgovor nosi field). | Uzmite šifru iz GET /v1/taxonomy/makes — npr. škoda, ne skoda. |
| 422 | unknown_model | Model nije u šifarniku te marke. | Uzmite šifru iz GET /v1/taxonomy/makes/{make}/models. |
| 422 | vehicle_type_unavailable | Procjene za tu vrstu vozila trenutno nisu dostupne. | Pokušajte kasnije ili se javite podršci. |
| 422 | as_of_in_future | as_of je u budućnosti. | Za buduće vrijednosti koristite prognozu (include: ["forecast"]). |
| 422 | as_of_too_early | as_of je prije 2015-01-01. | Pošaljite datum od 2015. naovamo. |
| 422 | year_after_as_of | Godište je kasnije od datuma procjene. | Provjerite year i as_of. |
| 422 | unsupported_listing_url | Iz linka se ne može pročitati stranica i broj oglasa. | Pošaljite link oglasa s olx.ba, autobum.ba ili autoplac.ba, ili source i listing_id. |
| 422 | not_owned | km_per_year, mileage_km ili exposure za traženo (wanted) vozilo. | Ta polja važe samo za vlastita (owned) vozila. |
| 422 | not_wanted | deal_pct za vlastito (owned) vozilo. | Povoljni oglasi se prate samo za tražena (wanted) vozila. |
| 429 | rate_limited | Previše zahtjeva u minuti. | Sačekajte Retry-After sekundi i ponovite; ravnomjerno raspodijelite zahtjeve. |
| 429 | quota_exceeded | Potrošena mjesečna kvota ugovora (odgovor nosi quota, used, resets_at). | Kvota se obnavlja 1. u mjesecu (UTC); za veću se javite prodaji. |
| 429 | key_limit_reached | Ključ 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. |
| 500 | internal_error | Greška na strani Cifre. | Ponovite zahtjev; ako se ponavlja, pošaljite request_id podršci. |
| 503 | model_unavailable | Model trenutno nije dostupan (npr. tokom pokretanja). | Ponovite za nekoliko sekundi, s eksponencijalnim čekanjem. |