API dokumentacija | Lokacija.net

Krajnja točka

POST /api/properties/submit/

Autentifikacija

Koristite API ključ u jednom od ovih zaglavlja:

X-API-Key: your-api-key
Authorization: Bearer your-api-key

Dobivanje API ključa

Zatražite API pristup iz svog profila i postavki. Nakon odobrenja, stvorite ključ tamo. Vidite Vodič za detalje.

Format zahtjeva

Pošaljite JSON u tijelu zahtjeva (ista struktura kao i primjeri datoteka):

{
  "property": {
    "title": "Modern apartment in Bežigrad",
    "description": "Spacious 85m² apartment...",
    "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"
  }
}

Primjer cURL-a

curl -X POST https://lokacija.net/api/properties/submit/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"property":{"title":"Test","street_number":"1","property_type":"apartment","listing_type":"sell","price":100000},"location":{"city":"Ljubljana","district":"Bežigrad","street":"Dunajska cesta"}}'

Odgovor

Uspjeh (201):

{"id": 123, "slug": "modern-apartment-id123", "status": "pending", "message": "Property submitted successfully. Pending review."}

Greška (400/401/403):

{"error": "Validation failed", "details": {...}}

Referenca na terenu

Polje	Type	Potreban	Bilješke
property.title	string	Da	Naslov nekretnine
property.street_number	string	Da	Zgrada/kućni broj
location.city	string	Da	Ime grada
location.district	string	Da	Naziv okruga
location.street	string	Da	Street name
property.price	number		Cijena u EUR
property.property_type	string		apartment, house, land, commercial, other
property.listing_type	string		sell, rent
property.description	string		Alias za slovenski opis (isto kao description_sl / naslijeđeni seo_description u uvozu)
property.description_sl / _hr / _sr / _en	string		Tekst popisa po jeziku
property.year_renovated	number		Godina obnove (nije obavezno)
property.bedrooms	number
property.bathrooms	number
property.area_sqm	number		Stambena površina u m²
property.amenities	array		balcony, parking, air_conditioning, garden, etc.

Uvoz datoteke

Također možete poslati putem prijenosa datoteke (JSON ili XML):

Preuzmi JSON primjer Preuzmi XML primjer Predajte imovinu Masovni uvoz

Na stranici za slanje upotrijebite "Uvezi iz datoteke" da unaprijed ispunite obrazac ili upotrijebite skupni uvoz za više svojstava.

Property Submission API