Sintaksa e filtrave të kërkimit

Filtrat janë parametra query-je në formatin me kllapa të PHP-së. Të njëjtët filtra funksionojnë te /search dhe /search/count; /cars pranon domains[] dhe is_leasing.

• Filtrat kategorikë marrin ID numerike. Shihni Vlerat e enum për çdo ID.
• currency ndikon vetëm në filtrimin dhe renditjen sipas çmimit. Çmimet e shpalljeve kthehen gjithmonë në monedhën e tyre origjinale.
• Për një VIN të saktë përdorni /cars/vin/{vin}. Filtri vin te /search është përputhje e pjesshme.
• Hiqni filtrat që nuk përdorni. Vlerat bosh validohen dhe mund të kthejnë 422.

is_auction pranon true, false, 1 ose 0 në /search, /search/count dhe /cars. False përfshin false, null dhe fushat që mungojnë. Pa parametër nuk ka filtër; vlerat boshe ose të pavlefshme kthejnë 422. is_auction dhe is_leasing duhet të përputhen me të njëjtin listim aktiv në një burim të lejuar/zgjedhur. Listime të tjera mund të mbeten në listings[]. Në /cars vendoseni në kërkesën e parë dhe ndiqni next_url pa ndryshime. Ndryshimi ose shtimi gjatë scroll, ose një vlerë e qartë kur mungon gjendja në cache, kthen 422. sort=auction_nearest kërkon auction_at >= now; dërgoni të njëjtin sort në /search/count.

Filtrimi sipas llojit dhe konfigurimit të mjetit

vehicle_type=automobile / 1 është parazgjedhja; motorcycle / 2 zgjedh motoçikleta në /search, /search/count dhe /cars. Përdorni të njëjtin lloj në fjalorë.

Hierarki e plotë: brands[] → models[] → generations[] → variants[] / trims[]. Çdo objekt marke, modeli dhe gjenerate kërkon id. OSE midis fqinjëve dhe vlerave variants/trims; DHE midis kushteve brenda një dege. Lista e munguar ose bosh nënkupton të gjithë pasardhësit. Deri në 100 elemente për listë. ID të panjohura ose të papajtueshme japin rezultat bosh; format i pavlefshëm — 422.

brands[0][models][]=573 ekzistues funksionon. Për pasardhës përdorni brands[0][models][0][id]=573. Pastroni fushën e vjetër të ID para objekteve të modeleve për atë markë, përndryshe PHP mbishkruan indeksin 0.

vehicle_type=motorcycle&brands[0][id]=101&brands[0][models][0][id]=201&brands[0][models][0][generations][0][id]=301&brands[0][models][0][generations][0][variants][]=501&brands[0][models][0][generations][0][trims][]=401

ID janë shembuj: zëvendësojini me vlerat e fjalorëve. Për çifte të caktuara variant/trim përdorni degë të ndara gjeneratash.

Përgjigjet përmbajnë vehicle_type, generation_id, variant_id dhe trim_id; ID opsionale të munguara janë null. Fushat marrin pjesë në hash. Kërkohen vetëm ID të ruajtura të mjetit: pa ID të normalizuar nuk ka përputhje me atë filtër.

Në /cars lloji dhe hierarkia fiksohen për kursorin. Ndiqni next_url pa ndryshime ose dërgoni vetëm scroll_id. Renditja e filtrave ekuivalentë mund të ndryshojë; kushte të reja ose filtra të shprehur pa gjendje të ruajtur japin 422. Nisni kursor të ri. Kursorët e vjetër pa parametra të rinj ruajnë kërkesën e tyre.

Fusha shtesë të njoftimeve

Ngarkoni /listing-fields pasi të kontrolloni çelësin. Përkufizimet, kufizimet, operatorët dhe shënimet vlejnë vetëm për atë çelës dhe domenet e zgjedhura.

Tekst: eq, in, exists. Numra dhe data edhe gt, gte, lt, lte. Boolean: eq ose exists. Përdorni eq, in, exists ose interval; exists veçmas. Deri në 20 fusha dhe 100 vlera në in.

Të gjitha kushtet, domenet dhe gjendja aktive duhet të përputhen në një njoftim. Zero dhe false janë vlera. Te vargjet mjafton një element që përputhet. Fushat/operatorët e panjohur ose të palejuar kthejnë 422.

Filtroni vetëm fushat filterable. Vlerat e indeksuara: listings[].custom_fields; të tjerat: listings[].source_data. Publikimi aktivizon filtrat; importet e zakonshme pasuese plotësojnë vlerat. Dokumentet e vjetra nuk plotësohen veçmas.

Në /cars kushtet ruhen për tërë scroll. Përkufizimi i papajtueshëm ose humbja e gjendjes së ruajtur kërkon scroll të ri. Renditja dhe agregimet nuk mbështeten.

Zëvendësoni FIELD_KEY me një çelës nga katalogu i lejuar. Për krahasime monetare vendosni monedhën e njoftimit; konvertimi Buy Now nuk zbatohet.

Vlerësimet historike të tregut nga burimi janë vlera informative pa indeksim. Përshkruajnë shitje të krahasueshme, jo çmimin, ofertën ose rezervën e këtij listimi. Kontrolloni përshkrimin e fushës, kriteret e krahasimit dhe datën e llogaritjes; mos supozoni monedhën e listimit. Fushat numerike të regjistruara mund të jenë null kur mungon vlerësimi.

custom_fields[FIELD_KEY][gte]=2
custom_fields[FIELD_KEY][in][]=a&custom_fields[FIELD_KEY][in][]=b
custom_fields[FIELD_KEY][eq]=false
custom_fields[FIELD_KEY][lte]=15000&custom_fields[FIELD_KEY][currency]=cad