Faqosja
Tri lloje listash përdorin tri stile faqosjeje. Zgjidhni endpoint-in sipas asaj që ju nevojitet, jo vetëm sipas grupit të filtrave.
| Numra faqesh | Kursor scroll | Kursor ID | |
|---|---|---|---|
| Endpoint-et | /search, /car-options | /cars | /countries, /locations |
| Kërkesa | page, perPage | Ndiqni next_url | after_id, per_page |
| Madhësia e faqes | 2–50, parazgjedhja 50 | 1–500, parazgjedhja 500 | 1–1,000, parazgjedhja 100 |
| Kufiri i thellësisë | page × perPage ≤ 10,000 | Asnjë, kursori jeton 1–15 min | Asnjë |
| Ndaloni kur | links.next është null | scroll_id është null | meta.has_more është false |
| Përdoreni për | Kërkim për përdoruesit | Sinkronizim i plotë i inventarit | Sinkronizim i fjalorëve |
Dy veçori të /search që duhen trajtuar në kod. data mund të mbajë një makinë më shumë se perPage (pamë 3 makina për perPage=2), prandaj prijeni në anën e klientit nëse ju duhet një madhësi e saktë. Dhe meta.total ndalet te 10,000: trajtojeni atë vlerë si "10,000 ose më shumë" dhe thirrni /search/count me të njëjtët filtra për numrin e saktë.
Fjalorët e automobilave dhe motoçikletave
Pa vehicle_type kthehen automobila; motorcycle / 2 zgjedh motoçikleta. Ruani llojin në çdo hap.
per_page është 1–100, si parazgjedhje 100. Përdorni page ose after_id, jo të dy. Për faqet: page × per_page ≤ 10000. Për të gjitha rezultatet dërgoni next_after_id si after_id pa page deri në has_more=false. Atëherë total numëron rezultatet e mbetura.
Pa faqëzim /brands dhe /models ruajnë listat dhe kufijtë e mëparshëm. Dërgoni per_page=100 për {data,meta}. generations e ndërfutura ruajnë {name,from,to}; ID e gjeneratave vijnë nga /generations/{model_id}.
{
"links": {
"first": "https://api.carstat.dev/search?perPage=2&page=1",
"last": "https://api.carstat.dev/search?perPage=2&page=5000",
"prev": null,
"next": "https://api.carstat.dev/search?perPage=2&page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 5000,
"path": "https://api.carstat.dev/search",
"per_page": 2,
"to": 3,
"total": 10000
}
}{
"data": [
"…3 countries…"
],
"meta": {
"per_page": 3,
"has_more": true,
"next_after_id": 3
}
}Merrni qasje në API
Lidhni çelësin për të ekzekutuar çdo kërkesë nga këto faqe me të dhënat tuaja. Ende pa çelës? Na kërkoni një çelës demo: i njëjti JSON si në planet me pagesë.