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
- Prijavite se na svoj nalog.
- Idite na Profil i podešavanja.
- U odeljku API pristup kliknite na „Zahtevaj pristup API-ju“.
- Naš tim će razmotriti vaš zahtev. Bićete obavešteni kada bude odobreno.
Korak 2: Kreirajte API ključ
Kada se pristup API-ju odobri:
- Idite na Profil i podešavanja.
- U odeljku Pristup API-ju unesite naziv opcionog ključa (npr. „Proizvodnja“ ili „Agencija KSIZ“).
- Kliknite na „Kreiraj API ključ“.
- Odmah kopirajte svoj ključ. Prikazuje se samo jednom i ne može se kasnije preuzeti.
- Č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:
- Idite na Submit properti.
- U odeljku „Uvoz iz datoteke“ preuzmite primer (JSON ili KSML).
- Popunite podatke o svojoj imovini koristeći primer formata.
- Otpremite datoteku i kliknite na „Uvezi i unapred popuni obrazac“.
- 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