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-keyAuthorization: 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.title | string | Da | Naslov imovine |
| property.street_number | string | Da | Broj zgrade/kuće |
| location.city | string | Da | Ime grada |
| location.district | string | Da | Naziv okruga |
| location.street | string | Da | Naziv ulice |
| property.price | number | Cena u EUR | |
| property.property_type | string | apartment, house, land, commercial, other (API vrednosti) | |
| property.listing_type | string | sell, rent (API vrednosti) | |
| property.description | string | Alias za slovenački opis (isto kao description_sl / legaci seo_description u uvozu) | |
| property.description_sl / _hr / _sr / _en | string | Tekst liste po jeziku | |
| property.year_renovated | number | Godina renoviranja (opciono) | |
| property.bedrooms | number | ||
| property.bathrooms | number | ||
| property.area_sqm | number | Stambena površina u m² | |
| property.amenities | array | balcony, 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.