Početak rada

Propertio je softver za agencije za nekretnine: oglasi, CRM (klijenti, upiti, pokazivanja), objava na portale (4zida, Halo oglasi, Nekretnine.rs …) i na sajt agencije. Svaka agencija je odvojena celina sa svojim oglasima, korisnicima i API ključevima.

Ova dokumentacija je za:

• web programere agencija i web studije koji na sajtu agencije prikazuju oglase iz Propertija i šalju upite nazad;
• portale i partnere koji preuzimaju oglase preko feeda ili primaju webhookove.

Administratorski API aplikacije (korisnici, podešavanja, back-office) nije javni i nije opisan ovde.

Okruženja

Okruženje	Bazni URL API-ja	Namena
Produkcija	https://app.propertio.rs/api	pravi oglasi agencije
Test	https://app.test.propertio.rs/api	probni podaci; ključevi iz produkcije tamo ne važe

Sve putanje javnog API-ja počinju sa /v1, na primer https://app.propertio.rs/api/v1/properties. Ključ važi samo u okruženju u kome je napravljen. Za razvoj tražite ključ test agencije.

1. Nabavite API ključ

Ključ izgleda ovako: pk_ab12cd34.<tajni deo>. Pravi ga Propertio tim, ili agencija sama u aplikaciji pod Portali i sajt → Vaš sajt → Ključevi za sajt kada je vlasnik uključio „Režim za programere“. Ključ se prikazuje samo jednom. Detalji, opsezi (public:read, public:inquiry) i ključevi za filijale: API ključevi.

2. Prvi zahtev

curl

curl -s -H "x-api-key: $PROPERTIO_API_KEY" \
  "https://app.propertio.rs/api/v1/agency"

SDK

import { PropertioClient } from "@propertio/sdk";

const propertio = new PropertioClient({
  baseUrl: "https://app.propertio.rs/api",
  apiKey: process.env.PROPERTIO_API_KEY!,
});
console.log(await propertio.agency.get());

fetch

const res = await fetch("https://app.propertio.rs/api/v1/agency", {
  headers: { "x-api-key": process.env.PROPERTIO_API_KEY! },
});
if (!res.ok) throw new Error(`${res.status} ${(await res.json()).message}`);
console.log(await res.json());

Odgovor:

{
  "name": "Agencija Primer",
  "slug": "agencija-primer",
  "email": "info@agencija.rs",
  "phone": "+381 11 123 4567",
  "website": "https://www.agencija.rs",
  "address": "Knez Mihailova 1, Beograd",
  "logoUrl": null,
  "defaultCurrency": "EUR",
  "branch": null
}

3. Oglasi na sajtu

curl -s -H "x-api-key: $PROPERTIO_API_KEY" \
  "https://app.propertio.rs/api/v1/properties?dealType=sale&city=Beograd&sort=priceAsc&page=1&pageSize=12"

Javni API vraća samo aktivne oglase koje je agencija objavila na sajt (kanal „Vaš sajt“). Ako oglas postoji u aplikaciji, a sajt ga ne vidi, proverite da li je objavljen na sajt. Vidi Oglasi i pretraga.

4. Upit sa sajta

curl -s -X POST -H "x-api-key: $PROPERTIO_API_KEY" -H "content-type: application/json" \
  -d '{"propertyId":"<id oglasa>","name":"Marko Marković","phone":"+381601234567","message":"Da li je stan još dostupan?","consent":true}' \
  "https://app.propertio.rs/api/v1/inquiries"

Upit stiže agentu u Propertio (CRM i obaveštenja). Vidi Upiti i pokazivanja.

Pravila koja važe svuda

• JSON u oba smera (content-type: application/json), osim zvuka (audio/mpeg) i feedova.
• Ključ u zaglavlju x-api-key, nikad u URL-u. Ključ čuvajte na serveru kad god možete (Bezbednost).
• Vreme je ISO 8601 (UTC u odgovorima, npr. 2026-10-20T08:30:00.000Z).
• Novac: price je broj u valuti oglasa (currency: EUR, RSD ili USD); za izdavanje je to mesečna cena.
• Greške imaju isti oblik: { statusCode, error, message, details? }. Vidi Greške, limiti, paginacija.
• Linkovi slika ističu posle 24 sata. Nikad ih ne čuvajte trajno (Slike).