Початок роботи

Пагінація

Три типи списків використовують три стилі пагінації. Обирайте ендпоінт за тим, що вам потрібно, а не лише за набором фільтрів.

	Номери сторінок	Курсор прокручування	Курсор за ID
Ендпоінти	`/search`, `/car-options`	`/cars`	`/countries`, `/locations`
Запит	`page`, `perPage`	Переходьте за `next_url`	`after_id`, `per_page`
Розмір сторінки	2–50, за замовчуванням 50	1–2,000, за замовчуванням 500	1–1,000, за замовчуванням 100
Ліміт глибини	page × perPage ≤ 10,000	Немає, курсор живе 1–15 хв	Немає
Зупинка, коли	`links.next` дорівнює null	`scroll_id` дорівнює null	`meta.has_more` дорівнює false
Для чого	Пошук для користувачів	Синхронізація всього каталогу	Синхронізація довідників

Дві особливості /search, які треба врахувати в коді. data може містити на один автомобіль більше, ніж perPage (ми бачили 3 автомобілі при perPage=2), тож обрізайте на клієнті, якщо потрібен точний розмір. А meta.total обмежується 10,000: сприймайте це значення як «10,000 або більше» і викликайте /search/count з тими самими фільтрами, щоб отримати точне число.

/search · links і metaНаживо

{
  "links": {
    "first": "https://api.lotarius.com/search?perPage=2&page=1",
    "last": "https://api.lotarius.com/search?perPage=2&page=5000",
    "prev": null,
    "next": "https://api.lotarius.com/search?perPage=2&page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5000,
    "path": "https://api.lotarius.com/search",
    "per_page": 2,
    "to": 3,
    "total": 10000
  }
}

/countries · metaНаживо

{
  "data": [
    "…3 countries…"
  ],
  "meta": {
    "per_page": 3,
    "has_more": true,
    "next_after_id": 3
  }
}