API za slanje nekretnina

Pošaljite svojstva programski preko REST API-ja. Idealno za agencije za nekretnine i integracije.

→ Korak po korak Kako koristiti API

Krajnja tač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

Dobijanje API ključa

Zatražite pristup API-ju sa svog profila i podešavanja. Kada se odobri, kreirajte ključ tamo. Vidite Vodič za detalje.

Format zahteva

Pošaljite JSON u telu zahteva (ista struktura kao primeri 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"
  }
}

cURL Primer

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

Uspeh (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 Vrsta Obavezno Napomene
property.titlestringDaNaslov imovine
property.street_numberstringDaBroj zgrade/kuće
location.citystringDaIme grada
location.districtstringDaNaziv okruga
location.streetstringDaNaziv ulice
property.pricenumberCena u EUR
property.property_typestringapartment, house, land, commercial, other (API vrednosti)
property.listing_typestringsell, rent (API vrednosti)
property.descriptionstringAlias za slovenački opis (isto kao description_sl / legaci seo_description u uvozu)
property.description_sl / _hr / _sr / _enstringTekst liste po jeziku
property.year_renovatednumberGodina renoviranja (opciono)
property.bedroomsnumber
property.bathroomsnumber
property.area_sqmnumberStambena površina u m²
property.amenitiesarraybalcony, parking, air_conditioning, garden itd. (API vrednosti)

File Import

Takođe možete da pošaljete putem otpremanja datoteke (JSON ili KSML):

Na stranici za slanje koristite „Uvezi iz datoteke“ da unapred popunite obrazac ili koristite grupni uvoz za više svojstava.