Property Submission API

Predložite lastnosti programsko prek REST API-ja. Idealno za nepremičninske agencije in integracije.

Končna točka

POST /api/properties/submit/

Preverjanje pristnosti

Uporabite ključ API v eni od teh glav:

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

Pridobivanje ključa API

Zahtevajte dostop do API-ja v svojem profilu in nastavitvah. Ko je odobren, tam ustvarite ključ. Glej Vodič za podrobnosti.

Oblika zahteve

Pošljite JSON v telesu zahteve (enaka struktura kot primeri datoteke):

{
  "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"
  }
}

Primer cURL

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"}}'

Odziv

Uspeh (201):

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

Napaka (400/401/403):

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

Referenca polja

Polje	Type	Obvezno	Opombe
property.title	string	Da	Naslov nepremičnine
property.street_number	string	Da	Stavba/hišna številka
location.city	string	Da	Ime mesta
location.district	string	Da	Ime okrožja
location.street	string	Da	Street name
property.price	number		Cena v EUR
property.property_type	string		apartment, house, land, commercial, other
property.listing_type	string		sell, rent
property.description	string		Vzdevek za slovenski opis (enako kot description_sl / legacy seo_description pri uvozih)
property.description_sl / _hr / _sr / _en	string		Besedilo seznama po jeziku
property.year_renovated	number		Leto prenove (neobvezno)
property.bedrooms	number
property.bathrooms	number
property.area_sqm	number		Bivalna površina v m²
property.amenities	array		balcony, parking, air_conditioning, garden, etc.

Uvoz datoteke

Oddate lahko tudi z nalaganjem datoteke (JSON ali XML):

Prenesi primer JSON Prenesi primer XML Predloži lastnino Množični uvoz

Na strani za oddajo uporabite »Uvozi iz datoteke«, da vnaprej izpolnite obrazec, ali uporabite množični uvoz za več lastnosti.