Kako se koristi API

Ovaj vodič objašnjava kako da pošaljete svojstva preko API-ja ili uvoza datoteke.

Korak 1: Zahtevajte pristup API-ju

  1. Prijavite se na svoj nalog.
  2. Idite na Profil i podešavanja.
  3. U odeljku API pristup kliknite na „Zahtevaj pristup API-ju“.
  4. Naš tim će razmotriti vaš zahtev. Bićete obavešteni kada bude odobreno.

Korak 2: Kreirajte API ključ

Kada se pristup API-ju odobri:

  1. Idite na Profil i podešavanja.
  2. U odeljku Pristup API-ju unesite naziv opcionog ključa (npr. „Proizvodnja“ ili „Agencija KSIZ“).
  3. Kliknite na „Kreiraj API ključ“.
  4. Odmah kopirajte svoj ključ. Prikazuje se samo jednom i ne može se kasnije preuzeti.
  5. Čuvajte ključ bezbedno. Nemojte ga deliti i ne stavljati na kontrolu verzija.

Korak 3: Pošaljite svojstvo preko API-ja

Pošaljite POST zahtev na:

https://lokacija.net/api/properties/submit/

Uključite svoj API ključ u zaglavlje zahteva:

X-API-Key: your-api-key

Ili:

Authorization: Bearer your-api-key

Pošaljite podatke o svojstvu kao JSON u telu zahteva. Primer:

{
  "property": {
    "title": "Modern apartment in Bežigrad",
    "description": "Spacious 85m² apartment with balcony.",
    "property_type": "apartment",
    "listing_type": "sell",
    "price": 285000,
    "street_number": "45",
    "bedrooms": 3,
    "bathrooms": 2,
    "area_sqm": 85,
    "amenities": ["balcony", "parking"]
  },
  "location": {
    "city": "Ljubljana",
    "district": "Bežigrad",
    "street": "Dunajska cesta"
  }
}

Alternativa: uvoz datoteke (nije potreban API ključ)

Takođe možete da pošaljete svojstva tako što ćete otpremiti JSON ili KSML datoteku:

  1. Idite na Submit properti.
  2. U odeljku „Uvoz iz datoteke“ preuzmite primer (JSON ili KSML).
  3. Popunite podatke o svojoj imovini koristeći primer formata.
  4. Otpremite datoteku i kliknite na „Uvezi i unapred popuni obrazac“.
  5. Pregledajte obrazac, dodajte fotografije ako je potrebno i pošaljite.

Za više svojstava odjednom koristite grupni uvoz.

Obavezna polja

  • property.title — Naslov imovine
  • property.street_number — Broj zgrade/kuće
  • location.city — Ime grada
  • location.district — Naziv okruga
  • location.street — Street name

Potrebna vam je pomoć?