API referencaŠifarnik

Marke

Sve marke koje Cifra procjenjuje, za jednu vrstu vozila, sa šiframa (slug) koje šaljete u procjeni. Besplatno; šifarnik se rijetko mijenja, pa ga keširajte (npr. jednom dnevno).

GEThttps://api.cifra.ba/v1/taxonomy/makes

Pristup: valuations
Obračun: Besplatno

GET/v1/taxonomy/makes

curl "https://api.cifra.ba/v1/taxonomy/makes?vehicle_type=car" \
  -H "Authorization: Bearer $CIFRA_API_KEY"

Odgovor

{
  "object": "list",
  "data": [
    {
      "slug": "alfa_romeo",
      "name": "Alfa Romeo",
      "models": 16
    },
    {
      "slug": "alpina",
      "name": "Alpina",
      "models": 2
    },
    {
      "slug": "aston_martin",
      "name": "Aston Martin",
      "models": 4
    },
    {
      "slug": "audi",
      "name": "Audi",
      "models": 54
    }
  ]
}

Parametri upita

vehicle_typeenumopcionalnopodrazumijevano "car"
Vrsta vozila čiji šifarnik tražite.
carmotorcycletruck

Odgovor

200

objectstringobavezno
list.
dataobject[]obavezno
Marke, abecedno.
Prikaži 3 poljaSakrij polja
- slugstringobavezno
  Šifra marke za zahtjeve.
- namestringobavezno
  Naziv za prikaz.
- modelsintegerobavezno
  Broj modela.

Greške

400
invalid_vehicle_type
vehicle_type nije car, motorcycle ni truck.

Uz ove, svaki poziv s ključem može vratiti opšte greške (ključ, pristup, limiti).

GET/v1/taxonomy/makes

curl "https://api.cifra.ba/v1/taxonomy/makes?vehicle_type=car" \
  -H "Authorization: Bearer $CIFRA_API_KEY"

Odgovor

{
  "object": "list",
  "data": [
    {
      "slug": "alfa_romeo",
      "name": "Alfa Romeo",
      "models": 16
    },
    {
      "slug": "alpina",
      "name": "Alpina",
      "models": 2
    },
    {
      "slug": "aston_martin",
      "name": "Aston Martin",
      "models": 4
    },
    {
      "slug": "audi",
      "name": "Audi",
      "models": 54
    }
  ]
}