Підключити ключ
GET/generations/{model_id}Довідники

Покоління транспорту

Активні покоління моделі: ID, роки випуску, пошук і пагінація. Типово автомобілі; vehicle_type=motorcycle — мотоцикли.

  • Без vehicle_type повертаються автомобілі; motorcycle / 2 вибирає мотоцикли. Зберігайте тип на кожному кроці.
  • ID моделі беріть із /models/{brand_id}. Активні покоління мають from_year, to_year, ordinal, code; query шукає й ці позначення. Невідомий батьківський запис або інший тип дає порожні дані.
  • per_page — 1–100, типово 100. Використовуйте page або after_id, не обидва. Для сторінок: page × per_page ≤ 10000. Для повного обходу передавайте next_after_id як after_id без page до has_more=false. Тоді total рахує решту збігів.

Параметри шляху

1
model_idinteger≥ 1Обов'язковий

Додатний ID батьківського запису з попереднього довідника; зберігайте vehicle_type.

Параметри запиту

6
vehicle_typestringdefault automobile

vehicle_type=automobile / 1 — типово; motorcycle / 2 вибирає мотоцикли в /search, /search/count і /cars. У довідниках використовуйте той самий тип.

querystring≤ 200 chars

Необов’язковий пошук назв і синонімів, до 200 символів. Порожній рядок вимикає пошук; * і ? — звичайний текст.

pageinteger1–10,000 · default 1

per_page — 1–100, типово 100. Використовуйте page або after_id, не обидва. Для сторінок: page × per_page ≤ 10000. Для повного обходу передавайте next_after_id як after_id без page до has_more=false. Тоді total рахує решту збігів.

per_pageinteger1–100 · default 100

per_page — 1–100, типово 100. Використовуйте page або after_id, не обидва. Для сторінок: page × per_page ≤ 10000. Для повного обходу передавайте next_after_id як after_id без page до has_more=false. Тоді total рахує решту збігів.

after_idinteger≥ 1

per_page — 1–100, типово 100. Використовуйте page або after_id, не обидва. Для сторінок: page × per_page ≤ 10000. Для повного обходу передавайте next_after_id як after_id без page до has_more=false. Тоді total рахує решту збігів.

langstring

Локаль відповіді. Переклади опцій також обмежено мовами акаунта. Сторінка автоматично обирає поточну мову.

Повертає · {data,meta}: ідентифікатори, точна кількість і наступна сторінка / ID-курсор.
GET/generations/{model_id}
curl -g "https://api.auctionsapi.com/generations/201?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ПрикладиПриклад
{2 keys
"data": [1 item
0: {9 keys
"id": 301
"name": "Example generation"
"brand_id": 101
"model_id": 201
"vehicle_type": 1
"from_year": 2020
"to_year": null
"ordinal": null
"code": "EX1"
}
]
"meta": {8 keys}
}

Отримайте доступ до API

Підключіть ключ, щоб виконувати будь-який запит із цих сторінок на своїх даних. Ключа ще немає? Попросіть у нас демо-ключ: той самий JSON, що й у платних планах.

У мене є ключ