V2 laukų žinynas

Vienodas griežtas XML ir JSON laukų kontraktas pagal skelbimo kategoriją.

Importo dokumentacijos meniu

Pasirinkite kategoriją ir peržiūrėkite visus priimamus V2 laukus bei galimas pasirinkimų reikšmes.

Skelbimo kategorijaIeškoti laukų

Tik privalomi laukai

<flat>

Laukų: 44

Butai

<flat>

Atnaujinimo taisyklė: Nepateikus pasirenkamo lauko ankstesnė importuota reikšmė išvaloma, nes kiekvienas V2 įrašas yra visa momentinė kopija. Pagrindinis kontakto vardas, telefonas ir el. paštas imami iš brokerio arba savininko.

Lauko kelias	Taisyklės ir pavyzdys	Privalomumas	Tipas	Kelios reikšmės
Tapatybė
`/domoplius/listings/flat/external_id` #	Pavyzdys:`100001`	Privalomas	`positive_integer`	Ne
`/domoplius/listings/flat/action_type` #	Apribojimai: leidžiamos reikšmės: 1, 3, 9 Pavyzdys:`1`	Privalomas	`option_id`	Ne
Kontaktai
`/domoplius/listings/flat/contact_name` #	Apribojimai: iki 50 simbolių Pavyzdys:`Partnerio brokeris`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/contact_phone` #	Apribojimai: iki 32 simbolių Pavyzdys:`+37060000000`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/contact_secondary_phone` #	Apribojimai: iki 32 simbolių Pavyzdys:`+37061111111`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/contact_email` #	Apribojimai: iki 100 simbolių; galiojantis el. pašto adresas Pavyzdys:`[email protected]`	Pasirenkamas	`email`	Ne
Kaina
`/domoplius/listings/flat/price_eur` #	Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio Pavyzdys:`145000`	Priklauso nuo sąlygų Privalomas, kai action_type reikšmė lygi 1, 3.	`decimal`	Ne
`/domoplius/listings/flat/short_rent_hour_eur` #	Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio Pavyzdys:`15`	Pasirenkamas	`decimal`	Ne
`/domoplius/listings/flat/short_rent_day_eur` #	Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio Pavyzdys:`75`	Priklauso nuo sąlygų Privalomas, kai action_type reikšmė lygi 9.	`decimal`	Ne
`/domoplius/listings/flat/short_rent_person_eur` #	Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio Pavyzdys:`25`	Pasirenkamas	`decimal`	Ne
Vieta
`/domoplius/listings/flat/administrative_unit_id` #	Pavyzdys:`461`	Privalomas	`positive_integer`	Ne
`/domoplius/listings/flat/settlement_id` #	Pavyzdys:`1`	Privalomas	`positive_integer`	Ne
`/domoplius/listings/flat/microdistrict_id` #	Pavyzdys:`31`	Pasirenkamas	`positive_integer`	Ne
`/domoplius/listings/flat/street_id` #	Pavyzdys:`22328`	Pasirenkamas	`positive_integer`	Ne
`/domoplius/listings/flat/building_number` #	Apribojimai: iki 32 simbolių Pavyzdys:`12A`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/unit_number` #	Apribojimai: iki 32 simbolių Pavyzdys:`4`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/hide_building_number` #	Apribojimai: leidžiamos reikšmės: false, true Pavyzdys:`false`	Pasirenkamas	`boolean`	Ne
`/domoplius/listings/flat/hide_unit_number` #	Apribojimai: leidžiamos reikšmės: false, true Pavyzdys:`false`	Pasirenkamas	`boolean`	Ne
`/domoplius/listings/flat/latitude` #	Apribojimai: ne mažiau nei -90; ne daugiau nei 90; iki 7 skaitmenų po kablelio; koordinatė iki septynių skaitmenų po kablelio Pavyzdys:`54.687157`	Pasirenkamas	`decimal`	Ne
`/domoplius/listings/flat/longitude` #	Apribojimai: ne mažiau nei -180; ne daugiau nei 180; iki 7 skaitmenų po kablelio; koordinatė iki septynių skaitmenų po kablelio Pavyzdys:`25.279652`	Pasirenkamas	`decimal`	Ne
Turinys ir medija
`/domoplius/listings/flat/description` #	Apribojimai: iki 65535 baitų Pavyzdys:`Šviesus butas.`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/video_url` #	Apribojimai: iki 2048 simbolių; Absoliutus HTTP(S) YouTube URL Pavyzdys:`https://www.youtube.com/watch?v=dQw4w9WgXcQ`	Pasirenkamas	`url`	Ne
`/domoplius/listings/flat/photos/photo_url` #	Apribojimai: iki 2048 simbolių; iki 30 reikšmių; absoliutus HTTP arba HTTPS URL Pavyzdys:`["https://example.lt/photo.jpg"]`	Pasirenkamas	`url_list`	Taip
Ypatumai
`/domoplius/listings/flat/features/feature_id` #	Apribojimai: daugiau nei 0; iki 85 reikšmių Pavyzdys:`[79]`	Pasirenkamas	`option_id_list`	Taip
Objekto duomenys
`/domoplius/listings/flat/flat_size` #	Apribojimai: daugiau nei 0; ne daugiau nei 99999999.99; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio Pavyzdys:`50.5`	Privalomas	`decimal`	Ne
`/domoplius/listings/flat/flat_rooms` #	Apribojimai: daugiau nei 0; ne daugiau nei 255 Pavyzdys:`1`	Privalomas	`integer`	Ne
`/domoplius/listings/flat/flat_floor` #	Apribojimai: ne mažiau nei 0; ne daugiau nei 255 Pavyzdys:`1`	Pasirenkamas	`integer`	Ne
`/domoplius/listings/flat/flat_situation_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/flat_in_floor_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/flat_door_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/flat_windows_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/construction_type_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/building_reconstruction_date` #	Apribojimai: iki 7 simbolių; metai nuo 1400 iki 2031; YYYY arba YYYY-MM Pavyzdys:`2020-05`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/building_water_supply_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/building_gas_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/building_sewerage_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/building_build_date` #	Apribojimai: iki 7 simbolių; metai nuo 1400 iki 2031; YYYY arba YYYY-MM Pavyzdys:`2020-05`	Pasirenkamas	`string`	Ne
`/domoplius/listings/flat/building_floors` #	Apribojimai: ne mažiau nei 0; ne daugiau nei 65535 Pavyzdys:`1`	Pasirenkamas	`integer`	Ne
`/domoplius/listings/flat/building_heating_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/energy_certificate_id` #	Apribojimai: daugiau nei 0 Pavyzdys:`1`	Pasirenkamas	`option_id`	Ne
`/domoplius/listings/flat/heating_taxes` #	Apribojimai: ne mažiau nei 0 Pavyzdys:`1`	Pasirenkamas	`integer`	Ne
`/domoplius/listings/flat/other_taxes` #	Apribojimai: ne mažiau nei 0 Pavyzdys:`1`	Pasirenkamas	`integer`	Ne
`/domoplius/listings/flat/interest_in_change` #	Apribojimai: leidžiamos reikšmės: false, true Pavyzdys:`false`	Pasirenkamas	`boolean`	Ne
`/domoplius/listings/flat/window_directions` #	Apribojimai: iki 64 simbolių; leidžiamos reikšmės: n, e, s, w; kableliais atskirti mažųjų raidžių krypčių kodai Pavyzdys:`n,e`	Pasirenkamas	`string`	Ne

Tapatybė

/domoplius/listings/flat/external_id #

Privalomaspositive_integer Kelios reikšmės: Ne

Pavyzdys:100001

/domoplius/listings/flat/action_type #

Privalomasoption_id Kelios reikšmės: Ne

Apribojimai: leidžiamos reikšmės: 1, 3, 9

Pavyzdys:1

Kontaktai

/domoplius/listings/flat/contact_name #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 50 simbolių

Pavyzdys:Partnerio brokeris

/domoplius/listings/flat/contact_phone #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 32 simbolių

Pavyzdys:+37060000000

/domoplius/listings/flat/contact_secondary_phone #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 32 simbolių

Pavyzdys:+37061111111

/domoplius/listings/flat/contact_email #

Pasirenkamasemail Kelios reikšmės: Ne

Apribojimai: iki 100 simbolių; galiojantis el. pašto adresas

Pavyzdys:[email protected]

Kaina

/domoplius/listings/flat/price_eur #

Priklauso nuo sąlygųdecimal Kelios reikšmės: Ne

Privalomas, kai action_type reikšmė lygi 1, 3.

Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio

Pavyzdys:145000

/domoplius/listings/flat/short_rent_hour_eur #

Pasirenkamasdecimal Kelios reikšmės: Ne

Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio

Pavyzdys:15

/domoplius/listings/flat/short_rent_day_eur #

Priklauso nuo sąlygųdecimal Kelios reikšmės: Ne

Privalomas, kai action_type reikšmė lygi 9.

Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio

Pavyzdys:75

/domoplius/listings/flat/short_rent_person_eur #

Pasirenkamasdecimal Kelios reikšmės: Ne

Apribojimai: daugiau nei 0; ne daugiau nei 28962001.85; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio

Pavyzdys:25

Vieta

/domoplius/listings/flat/administrative_unit_id #

Privalomaspositive_integer Kelios reikšmės: Ne

Pavyzdys:461

/domoplius/listings/flat/settlement_id #

Privalomaspositive_integer Kelios reikšmės: Ne

Pavyzdys:1

/domoplius/listings/flat/microdistrict_id #

Pasirenkamaspositive_integer Kelios reikšmės: Ne

Pavyzdys:31

/domoplius/listings/flat/street_id #

Pasirenkamaspositive_integer Kelios reikšmės: Ne

Pavyzdys:22328

/domoplius/listings/flat/building_number #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 32 simbolių

Pavyzdys:12A

/domoplius/listings/flat/unit_number #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 32 simbolių

Pavyzdys:4

/domoplius/listings/flat/hide_building_number #

Pasirenkamasboolean Kelios reikšmės: Ne

Apribojimai: leidžiamos reikšmės: false, true

Pavyzdys:false

/domoplius/listings/flat/hide_unit_number #

Pasirenkamasboolean Kelios reikšmės: Ne

Apribojimai: leidžiamos reikšmės: false, true

Pavyzdys:false

/domoplius/listings/flat/latitude #

Pasirenkamasdecimal Kelios reikšmės: Ne

Apribojimai: ne mažiau nei -90; ne daugiau nei 90; iki 7 skaitmenų po kablelio; koordinatė iki septynių skaitmenų po kablelio

Pavyzdys:54.687157

/domoplius/listings/flat/longitude #

Pasirenkamasdecimal Kelios reikšmės: Ne

Apribojimai: ne mažiau nei -180; ne daugiau nei 180; iki 7 skaitmenų po kablelio; koordinatė iki septynių skaitmenų po kablelio

Pavyzdys:25.279652

Turinys ir medija

/domoplius/listings/flat/description #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 65535 baitų

Pavyzdys:Šviesus butas.

/domoplius/listings/flat/video_url #

Pasirenkamasurl Kelios reikšmės: Ne

Apribojimai: iki 2048 simbolių; Absoliutus HTTP(S) YouTube URL

Pavyzdys:https://www.youtube.com/watch?v=dQw4w9WgXcQ

/domoplius/listings/flat/photos/photo_url #

Pasirenkamasurl_list Kelios reikšmės: Taip

Apribojimai: iki 2048 simbolių; iki 30 reikšmių; absoliutus HTTP arba HTTPS URL

Pavyzdys:["https://example.lt/photo.jpg"]

Ypatumai

/domoplius/listings/flat/features/feature_id #

Pasirenkamasoption_id_list Kelios reikšmės: Taip

Apribojimai: daugiau nei 0; iki 85 reikšmių

Pavyzdys:[79]

Objekto duomenys

/domoplius/listings/flat/flat_size #

Privalomasdecimal Kelios reikšmės: Ne

Apribojimai: daugiau nei 0; ne daugiau nei 99999999.99; iki 2 skaitmenų po kablelio; dešimtainis skaičius iki dviejų skaitmenų po kablelio

Pavyzdys:50.5

/domoplius/listings/flat/flat_rooms #

Privalomasinteger Kelios reikšmės: Ne

Apribojimai: daugiau nei 0; ne daugiau nei 255

Pavyzdys:1

/domoplius/listings/flat/flat_floor #

Pasirenkamasinteger Kelios reikšmės: Ne

Apribojimai: ne mažiau nei 0; ne daugiau nei 255

Pavyzdys:1

/domoplius/listings/flat/flat_situation_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/flat_in_floor_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/flat_door_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/flat_windows_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/construction_type_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/building_reconstruction_date #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 7 simbolių; metai nuo 1400 iki 2031; YYYY arba YYYY-MM

Pavyzdys:2020-05

/domoplius/listings/flat/building_water_supply_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/building_gas_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/building_sewerage_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/building_build_date #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 7 simbolių; metai nuo 1400 iki 2031; YYYY arba YYYY-MM

Pavyzdys:2020-05

/domoplius/listings/flat/building_floors #

Pasirenkamasinteger Kelios reikšmės: Ne

Apribojimai: ne mažiau nei 0; ne daugiau nei 65535

Pavyzdys:1

/domoplius/listings/flat/building_heating_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/energy_certificate_id #

Pasirenkamasoption_id Kelios reikšmės: Ne

Apribojimai: daugiau nei 0

Pavyzdys:1

/domoplius/listings/flat/heating_taxes #

Pasirenkamasinteger Kelios reikšmės: Ne

Apribojimai: ne mažiau nei 0

Pavyzdys:1

/domoplius/listings/flat/other_taxes #

Pasirenkamasinteger Kelios reikšmės: Ne

Apribojimai: ne mažiau nei 0

Pavyzdys:1

/domoplius/listings/flat/interest_in_change #

Pasirenkamasboolean Kelios reikšmės: Ne

Apribojimai: leidžiamos reikšmės: false, true

Pavyzdys:false

/domoplius/listings/flat/window_directions #

Pasirenkamasstring Kelios reikšmės: Ne

Apribojimai: iki 64 simbolių; leidžiamos reikšmės: n, e, s, w; kableliais atskirti mažųjų raidžių krypčių kodai

Pavyzdys:n,e

API integratoriams

Papildoma informacija klientams, kurie sinchronizuoja viešus laukų, pasirinkimų ir adresų API duomenis.

XML dokumentui privaloma V2 vardų sritis ir version="2"; JSON neturi version lauko. Abu formatai naudoja tuos pačius skelbimo laukus.
Nežinomi laukai, alias, pasikartojantys vienetiniai laukai ir neteisingos kolekcijos atmetami.
Skaitinius parinkčių ir vietų ID gaukite iš V2 endpointų, o ne įrašykite tiesiai programos kode.
Atsakymai palaiko ETag, penkių minučių podėlį ir užklausų ribojimą.