Propertio Developers

Tema

Propertio za programereOglasi agencije na vašem sajtu, za jedno popodne.

Javni API, TypeScript SDK, webhookovi i XML/JSON feedovi za sajtove agencija za nekretnine, web studije i partnere.

Početak rada
@propertio/sdk
API referenca

Javni API (/v1)

Pretraga i detalj oglasa, agencija, agenti, upiti i zahtevi za pokazivanje. JSON preko HTTPS-a, ključ u zaglavlju x-api-key.

Oglasi i pretraga

TypeScript SDK

npm i @propertio/sdk: tipovi, paginacija, pomoćne funkcije za slike i cene. Radi u Node.js, Next.js, Astro i u browseru.

SDK

AI asistent i glas

Asistent na sajtu koji pronalazi oglase, odgovara posetiocima i zakazuje pokazivanja, uz izgovor odgovora glasom agencije.

Asistent i glas

Webhookovi

Potpisani JSON događaji (HMAC-SHA256) kad se oglas objavi, izmeni ili skine, za ISR, keš ili sopstvenu bazu.

Webhookovi

XML / JSON / CSV feedovi

Feedovi zaštićeni tokenom za portale i partnere, uključujući 4zida format sa trajnim, čitljivim linkom.

Feedovi

OpenAPI 3.1

Mašinski čitljiv opis javnog API-ja. Preuzmite ga i generišite klijent za PHP, Python, C# ili bilo koji jezik.

OpenAPI referenca

Kako izgleda integracija ​

  1. Agencija dobija API ključ (pk_…) za svoj sajt. Ključ pravi Propertio tim ili vlasnik agencije. Vidi API ključevi.
  2. Sajt čita oglase iz Propertija preko javnog API-ja ili SDK-a, po mogućstvu sa servera.
  3. Upiti i pokazivanja sa sajta idu nazad u Propertio (upiti) i stižu agentu u CRM i kalendar.
  4. Po želji: webhook javlja sajtu kad se oglas promeni, pa stranica može da se osveži odmah.
bash
curl -H "x-api-key: $PROPERTIO_API_KEY" \
  "https://app.propertio.rs/api/v1/properties?dealType=sale&city=Beograd&pageSize=3"

Primer sajta

U repozitorijumu je mali sajt agencije napravljen na SDK-u (apps/demo-site): lista oglasa, detalj, upit, zahtev za pokazivanje i asistent. Opisan je u Primerima.