Brzi početak

1. 1

   Napravite ključ

   Na platformi otvorite Razvoj → API ključevi i napravite testni ključ (cfr_test_…). Testni ključ provjerava zahtjeve kao pravi, vraća fiksne primjer-vrijednosti i ništa ne naplaćuje.

   API je dio Business i Enterprise plana. Nemate nalog? Isprobajte Business 7 dana ili nam pišite.
2. 2

   Sačuvajte ključ

   Ključ se prikazuje samo jednom. Držite ga u varijabli okruženja ili trezoru tajni, nikad u kodu:

   export CIFRA_API_KEY="cfr_test_…"

3. 3

   Pošaljite procjenu

   Obavezni su samo marka, model, godište i kilometraža. Šifre marki i modela su u šifarniku.

   POST/v1/valuations

   cURL

   curl -X POST "https://api.cifra.ba/v1/valuations" \
     -H "Authorization: Bearer $CIFRA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "make": "škoda",
       "model": "octavia",
       "year": 2015,
       "mileage_km": 210000,
       "include": []
     }'

4. 4

   Pročitajte odgovor

   market_value.point je tržišna vrijednost u KM, low–high raspon u kojem je cijena s vjerovatnoćom od 80%, a confidence_grade koliko je raspon uzak. warnings kaže šta bi poboljšalo procjenu:

   JSON

   {
     "id": "val_gcizgqyFRuEGurraw8v6",
     "object": "valuation",
     "created_at": "2026-10-18T21:57:27.584Z",
     "model_version": "car-20261017-1",
     "valued_by": {
       "kind": "standard",
       "version": "car-20261017-1"
     },
     "vehicle": {
       "vehicle_type": "car",
       "make": "škoda",
       "make_name": "Škoda",
       "model": "octavia",
       "model_name": "Octavia",
       "year": 2015,
       "mileage_km": 210000
     },
     "as_of": "2026-10-18",
     "market_value": {
       "currency": "BAM",
       "point": 15600,
       "low": 12370,
       "high": 19690,
       "confidence_grade": "B",
       "range_probability": 0.8,
       "definition": "Asking price at which a comparable vehicle is listed by a private seller on the valuation date; the range holds the price with 80% probability."
     },
     "sale_price": {
       "status": "unavailable",
       "detail": "Needs transaction data; planned as an experimental output."
     },
     "time_to_sell": {
       "status": "unavailable",
       "detail": "Needs a few months of market exit data; planned."
     },
     "warnings": [
       {
         "code": "partial_inputs",
         "message": "Add power, engine size, fuel and transmission for a tighter range."
       }
     ]
   }

5. 5

   Pređite na produkcijski ključ

   Kad integracija radi, napravite live ključ (cfr_live_…) samo s pristupom koji treba i, ako zovete sa poznatih servera, s listom dozvoljenih IP adresa. Live procjene se naplaćuju po jedinici.

Dalje#