GET/searchAutomjete

Kërkoni automjete

Filtroni automjetet aktive në burimet tuaja të aktivizuara. Rezultatet janë të lehta: çdo makinë mban flamuj raportesh, jo trupat e raporteve.

perPage është 2–50 (parazgjedhja 50). perPage=1 kthen 422.
Mbajeni page × perPage deri në 10,000. Për të lexuar më tej, përdorni /cars.
data mund të përmbajë perPage + 1 makina, dhe meta.total ndalet te 10,000. Përdorni /search/count për totale të sakta.
Renditjet sipas çmimit (cheaper, expensive) i krahasojnë çmimet në currency.

Parametrat e query-t

Query, faqosja dhe shtrirja

querystring≤ 200 chars

Kërkim me tekst të plotë i automjeteve. Hiqni filtrat e papërdorur.

vinstring1–19 chars

VIN i pjesshëm, pa dallim shkronjash të mëdha/të vogla. Për një VIN të saktë me 16–19 karaktere, përdorni /cars/vin/{vin}.

pageinteger≥ 1 · default 1

Numri i faqes. Për /search, kaloni perPage në mënyrë eksplicite dhe mbajeni page × perPage ≤ 10000. /search/count e injoron faqosjen dhe e anashkalon këtë kontroll të zhvendosjes.

perPageinteger2–50 · default 50

Madhësia e faqes së kërkimit: minimumi 2, maksimumi 50. perPage=1 kthen 422; përdorni perPage=2 për të marrë një mostër të vogël. Vlerat e faqosjes që mungojnë ose janë null përdorin page=1 dhe perPage=50, përfshirë kontrollin e dritares së rezultateve të kërkimit. Vlerat e pavlefshme kthejnë 422.

sortstring

Rendi i renditjes. Renditja sipas çmimit kërkon një monedhë të zbërthyer.

currencystring3 chars · default usd

Kodi i monedhës, pa dallim shkronjash të mëdha/të vogla, për filtrimin/renditjen sipas çmimit. Duhet të ekzistojë në fjalorin e monedhave. Nuk i konverton çmimet e serializuara të shpalljeve.

currency_idinteger≥ 1

ID e brendshme opsionale e monedhës; ka përparësi ndaj currency.

domains[]integer[]≥ 1

Shtrirje opsionale e burimeve. Përdorni ID-të e kthyera nga GET /domains. Hiqeni për të përdorur të gjitha domenet e aktivizuara. Përsëritni parametrin me kllapa: domains[]=33&domains[]=34. Çdo ID duhet të jetë e aktivizuar për këtë çelës.

langstring

Gjuha e përgjigjes. Përkthimet e opsioneve kufizohen gjithashtu nga gjuhët e llogarisë. Faqja e zgjedh automatikisht gjuhën e saj aktuale.

Marka, modeli dhe vendndodhja

brands[0][id]integer

ID e markës së parë nga /brands. Markat shtesë përdorin brands[1][id], etj.

brands[0][models][]integer[]

ID opsionale modelesh për markën e parë, të kthyera nga /models/{brand_id}. Hiqeni për të gjitha modelet.

countries[0][id]integer

ID e brendshme e shtetit të parë nga /countries. Shtetet shtesë përdorin countries[1][id], etj.

countries[0][regions][]integer[]

ID të brendshme opsionale rajonesh që i përkasin shtetit të parë.

Intervalet

seatsinteger1–200

Numri i saktë i vendeve.

price_fromint64≥ 0

Çmimi minimal i shpalljes në monedhën e zgjedhur. Maksimumi 9223372036854775807 (numër i plotë 64-bit me shenjë); vlerat përtej numrave të plotë të sigurt të JavaScript duhet të ruhen nga klientët si tekst dhjetor.

price_toint64≥ 1

Çmimi maksimal i shpalljes në monedhën e zgjedhur. Maksimumi 9223372036854775807 (numër i plotë 64-bit me shenjë); vlerat përtej numrave të plotë të sigurt të JavaScript duhet të ruhen nga klientët si tekst dhjetor.

year_frominteger1,800–3,000

Viti minimal i prodhimit.

year_tointeger1,800–3,000

Viti maksimal i prodhimit.

odometer_frominteger0–999,999,999

Kilometrazhi minimal në kilometra.

odometer_tointeger0–999,999,999

Kilometrazhi maksimal në kilometra.

engine_volume_frominteger0–999,999,999

Kilindrata minimale e motorit.

engine_volume_tointeger0–999,999,999

Kilindrata maksimale e motorit.

power_hp_frominteger0–100,000

Fuqia minimale në kuaj-fuqi.

power_hp_tointeger1–100,000

Fuqia maksimale në kuaj-fuqi.

Flamujt

is_leasingboolean

Filtër opsional i lizingut. Dërgoni true (ose 1) për shpalljet e shënuara shprehimisht is_leasing=true. Dërgoni false (ose 0) për të përjashtuar true, duke përfshirë false të ruajtur, null dhe fushat që mungojnë. Hiqeni për të mos filtruar sipas lizingut; vlerat bosh ose të pavlefshme kthejnë 422. Një makinë duhet të ketë të paktën një shpallje aktive që përputhet në shtrirjen e domeneve të aktivizuara/zgjedhura. Shpalljet e tjera mund të mbeten në përgjigje, prandaj makinat me lloje të përziera shpalljesh mund të përputhen me të dyja vlerat. Për /cars, vendoseni këtë në kërkesën e parë dhe ndiqni next_url të pandryshuar; false ruhet. Vazhdimi vetëm me scroll_id e ruan filtrin. Ndryshimi ose shtimi i filtrit gjatë scroll-it kthen 422. Nëse gjendja e filtrit në cache humbet ose scroll-i është më i vjetër se ky parametër, një vlerë eksplicite kthen 422; filloni një scroll të ri.

keys_availableinteger

Shpallja ka çelësa. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

is_manufacturer_certifiedinteger

Shpallja është e certifikuar nga prodhuesi ose nga programi zyrtar i shitësit. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

has_inspectionsinteger

Makina rrënjë ka një inspektim publik. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

has_history_reportsinteger

Një shpallje në shtrirjen e domeneve të zgjedhura ka një raport historiku publik. Dërgoni 1 (true) ose 0 (false). Hiqeni për cilëndo vlerë; vargjet "true"/"false" refuzohen.

Kategoritë

body_types[]integer[]

Repeat to match any of the values.

colors[]integer[]

Repeat to match any of the values.

fuels[]integer[]

Repeat to match any of the values.

transmissioninteger

One value.

seller_typeinteger

One value.

steering_wheel_positioninteger

One value.

airbagsinteger

One value.

damages[]integer[]

Repeat to match any of the values.

conditions[]integer[]

Repeat to match any of the values.

availabilities[]integer[]

Repeat to match any of the values.

emissions[]integer[]

Repeat to match any of the values.

drive_wheels[]integer[]

Repeat to match any of the values.

Kthen · Një faqe me objekte Car në data, me links dhe meta. Vargjet inspections dhe vehicle_history_reports mungojnë.

GET/search

curl -g "https://api.lotarius.com/search?perPage=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

ShembujI regjistruar

{3 keys

"data": [1 item

0: {21 keys

"id": "l_eCJb-8zB_XcJ-z6Y7oZWjw"

"has_inspections": true

"has_history_reports": true

"year": 2014

"month": 4

"vin": "wddhf0cb3ea952710"

"brand": {2 keys

}

"model": {2 keys

}

"engine_volume": 2143

"seats": 5

"body_type": {2 keys

}

"transmission": {2 keys

}

"transmission_steps": 6

"fuel": {2 keys

}

"color": {2 keys

}

"power_hp": 170

"market_origin": {2 keys

}

"badge": "E220 CDI Avantgarde"

"option_ids": [53 items

]

"listings": [1 item

]

"hash": "093563801f92d9cfa23a07346b26b69db32df8da05d7c5ee60fa5fd876a7fe0b"

}

]

"links": {4 keys

}

"meta": {7 keys

}