Agencija i agenti

GET /v1/agency · GET /v1/agents · opseg public:read

Profil agencije

Za zaglavlje i podnožje sajta, stranicu „Kontakt“ i strukturirane podatke (schema.org RealEstateAgent).

GET /api/v1/agency
x-api-key: pk_…

{
  "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": "https://www.agencija.rs/logo.png",
  "defaultCurrency": "EUR",
  "branch": null
}

Polje	Napomena
email, phone, address	mogu biti null
website, logoUrl	samo http(s) adrese, inače null (bezbedno za href i src)
defaultCurrency	valuta koju agencija podrazumeva (EUR, RSD ili USD)
branch	null za ključ cele agencije; za ključ filijale { id, name, slug, accent }, a kontakt i logo su filijalini (prazna polja preuzimaju vrednosti agencije)

Profil se retko menja: keširajte ga satima.

Agenti

GET /api/v1/agents
x-api-key: pk_…

[
  { "id": "a7c2…", "name": "Jelena Petrović", "phone": "+381 64 111 2233", "email": "jelena@agencija.rs", "activeListings": 12 },
  { "id": "b913…", "name": "Nikola Jovanović", "phone": null, "email": "nikola@agencija.rs", "activeListings": 0 }
]

Vraća aktivne korisnike agencije koji nisu samo u ulozi „Pregled“ (vlasnik, menadžeri, agenti). activeListings je broj aktivnih oglasa koje vode. Za stranicu „Naš tim“ obično prikažite one sa activeListings > 0. Sa ključem filijale lista sadrži ljude te filijale i agente bez filijale koji vode njene oglase.

Lični podaci

Imena, telefoni i emailovi agenata su lični podaci zaposlenih. Prikazujte ih samo na sajtu agencije, ne kopirajte ih u druge sisteme, i ne pravite od njih javnu listu za preuzimanje.

Oglas već nosi svog agenta u polju agent ({ id, name, phone, email }), pa za stranicu oglasa ne treba poseban poziv.