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

Заводські варіанти

Заводські варіанти покоління з поточної опублікованої конфігурації, пошук і пагінація. Типово автомобілі; vehicle_type=motorcycle — мотоцикли.

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

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

1
generation_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/variants/{generation_id}
curl -g "https://api.auctionsapi.com/variants/301?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ПрикладиПриклад
{2 keys
"data": [1 item
0: {6 keys
"id": 501
"name": "Example variant"
"brand_id": 101
"model_id": 201
"generation_id": 301
"vehicle_type": 1
}
]
"meta": {8 keys}
}

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

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

У мене є ключ