Kako uporabljati API

1. korak: Zahtevajte dostop do API-ja

1. Prijavite se v svoj račun.
2. Pojdite na Profil in nastavitve.
3. V razdelku za dostop do API-ja kliknite »Zahtevaj dostop do API-ja«.
4. Naša ekipa bo pregledala vašo zahtevo. Ob odobritvi boste obveščeni.

2. korak: Ustvarite ključ API

Ko je dostop API odobren:

1. Pojdite na Profil in nastavitve.
2. V razdelek za dostop do API-ja vnesite neobvezno ime ključa (npr. 'Proizvodnja' ali 'Agencija XYZ').
3. Kliknite »Ustvari ključ API«.
4. Takoj kopirajte svoj ključ. Prikazan je samo enkrat in ga pozneje ni mogoče priklicati.
5. Ključ varno shranite. Ne dajajte ga v skupno rabo in ga ne dodelite nadzoru različic.

3. korak: Predložite lastnino prek API-ja

Pošljite zahtevo POST na:

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

V glavo zahteve vključite svoj ključ API:

X-API-Key: your-api-key

ali:

Authorization: Bearer your-api-key

Pošljite podatke o lastnostih kot JSON v telesu zahteve. 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 (ključ API ni potreben)

Lastnosti lahko predložite tudi tako, da naložite datoteko JSON ali XML:

1. Pojdite na Predloži lastnino.
2. V razdelku »Uvozi iz datoteke« prenesite primer (JSON ali XML).
3. Izpolnite podatke o svoji nepremičnini z uporabo vzorčne oblike.
4. Naložite datoteko in kliknite »Uvozi in vnaprej izpolni obrazec«.
5. Preglejte obrazec, po potrebi dodajte fotografije in pošljite.

Za več lastnosti hkrati uporabite množični uvoz.

Obvezna polja

• property.title — Naslov nepremičnine
• property.street_number — Stavba/hišna številka
• location.city — Ime mesta
• location.district — Ime okrožja
• location.street — Street name

Potrebujete pomoč?