Kako koristiti API

Korak 1: Zatražite pristup API-ju

1. Prijavite se na svoj račun.
2. Idite na Profil i postavke.
3. U odjeljku za pristup API-ju kliknite na "Zatraži pristup API-ju".
4. Naš tim će pregledati vaš zahtjev. Bit ćete obaviješteni kada bude odobreno.

Korak 2: Izradite API ključ

Nakon što se odobri pristup API-ju:

1. Idite na Profil i postavke.
2. U odjeljku za pristup API-ju unesite izborni naziv ključa (npr. 'Proizvodnja' ili 'Agencija XYZ').
3. Kliknite 'Stvori API ključ'.
4. Odmah kopirajte svoj ključ. Prikazuje se samo jednom i ne može se kasnije dohvatiti.
5. Pohranite ključ na sigurno mjesto. Nemojte ga dijeliti niti ga predati kontroli verzija.

Korak 3: Pošaljite svojstvo putem API-ja

Pošaljite POST zahtjev na:

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

Uključite svoj API ključ u zaglavlje zahtjeva:

X-API-Key: your-api-key

Ili:

Authorization: Bearer your-api-key

Pošaljite podatke o svojstvu kao JSON u tijelu zahtjeva. Primjer:

{
  "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đer možete poslati svojstva učitavanjem JSON ili XML datoteke:

1. Idite na Pošalji svojstvo.
2. U odjeljku "Uvoz iz datoteke" preuzmite primjer (JSON ili XML).
3. Ispunite podatke o svojoj nekretnini koristeći primjer formata.
4. Učitajte datoteku i kliknite "Uvezi i unaprijed ispuni obrazac".
5. Pregledajte obrazac, dodajte fotografije ako je potrebno i pošaljite.

Za više svojstava odjednom koristite Skupni uvoz.

Obavezna polja

• property.title — Naslov nekretnine
• property.street_number — Zgrada/kućni broj
• location.city — Ime grada
• location.district — Naziv okruga
• location.street — Street name

Trebate pomoć?