Kihagyás

Értékesítők listázása

A hitelesített felhasználóval "látható" irodákhoz felvett értékesítőket listázza a parancs.

HTTP kérés

GET /seller

Példa

GET /seller?part=id&created_after=2019-03-05T12:23:01

Példa

GET /seller?part=id,seller&id=3456777,3456778,3456779

Példa

GET /seller?part=id,seller&transfer_id=v45a793z&office_id=15

Példa

GET /seller?part=images.id&office_id=15
Kötelező mező Leírás
part string
A válaszban megjelenítendő elemek, vesszővel elválasztva.
- "id": Azonosítás
- "seller": Értékesítő adatok
- "images.id": Képek azonosítása
- "images.image": Kép alapadatok
Opcionális mező Leírás
office_id uint(20)
Az iroda Ingatlanok.hu rendszerbeli azonosítója.
id uint(20)*
(A transfer_id mezővel kölcsönösen kizárt) Az értékesítő Ingatlanok.hu rendszerbeli azonosítója. Több is megadható, vesszővel elválasztva.
transfer_id string(1-40)*
(Az id mezővel kölcsönösen kizárt) Az értékesítőnek a felvételkor megadott (külső) azonosítója. Több is megadható, vesszővel elválasztva.
created_after datetime
Szűrés a megadottnál később felvett értékesítőre.
updated_after datetime
Szűrés a megadottnál később módosított értékesítőre.

Tartalom

A kérésnek nincs tartalmi része.

Válasz

Minden listaelem két részből tevődik össze:

  • Az Általános részben taglalt mezőkből.
  • Az images blokkban vannak a Képek részben taglalt elemek.

Megjegyzés

Hiba esetén a lehetséges válaszok megtalálhatók a Hibák oldalon.

Általános

Példa

HTTP 200 OK

[
    {
        "id": {
            "id": "45436",
            "transfer_id": "ert123",
            "office_id": 10
        },
        "seller" {
            "id": "45436",
            "username": "gipsz@mail.hu",
            "name": "Gipsz Jakab",
            "phone": "+36-20-111-33-55",
            "email": "gipsz@mail.hu",
            "public_email": "gipsz2@mail.hu",
            "max_estate_number": 200,
            "can_manage_properties": false
        },
        "images": [

        ]
    }
]

Mező Leírás
id Értékesítő azonosítása.
id.id Az értékesítő Ingatlanok.hu rendszerbeli azonosítója.
id.transfer_id string(1-40)
Az értékesítőnek a felvételkor megadott (külső) azonosítója.
id.office_id uint(20)
Az iroda Ingatlanok.hu rendszerbeli azonosítója.
seller Értékesítő adatai.
seller.id Az értékesítő Ingatlanok.hu rendszerbeli azonosítója.
seller.name string(3-64)
Értékesítő neve.
seller.phone string(8-64)
Értékesítő telefonszáma.
seller.email string(128)
Értékesítő belső e-mail címe.
seller.username string(255)
Értékesítő felhasználóneve.
seller.public_email string(128)
Értékesítő látható e-mail címe. Hiányában a belső e-mail cím lesz megjelenítve.
seller.max_estate_number uint(8)
Az értékesítő által kezelhető ingatlanok maximális száma.
seller.can_manage_properties bool
Ingatlanok módosítása engedélyezett-e.
true: igen
false: nem

Képek

Megjegyzés

Az itt feltüntetett adatok az Általános részben taglalt JSON images mezőjébe kerülnek part=images.* esetén.

Példa

{
    "id": {
        "id": 98303450,
        "transfer_id": "seller-8349-img-70947"
    },
    "image": {
        "id": 98303450,
        "long_title": "Nagyméretű kép címe",
        "short_title": "Kisméretű kép címe",
        "order": 1,
        "url": "/2019/04/27/16/47/98300.jpg"
    }
}
Mező Leírás
id (A part=images.id esetén) A kép beazonosítása.
id.id uint(20)
Az Ingatlanok.hu rendszerbeli azonosító.
id.transfer_id string(1-40)
A felvételkor megadott (külső) azonosító.
image (A part=images.image esetén) A kép beazonosítása.
image.id uint(20)
Az Ingatlanok.hu rendszerbeli azonosító.
image.long_title string
A teljes (nagy)méretű kép címe, megjegyzése.
image.short_title string
A minta (kisméretű) kép címe, megjegyzése.
image.order uint(10)
A megjelenítés sorrendjét meghatározó sorszám. Ez az érték szerinti növekvő sorrendben vannak a képek megjelenítve.
image.url Az eredeti képfájl elérhetősége HTTP vagy HTTPS protokolon keresztül.