GET/trims/{generation_id}Справочники

Комплектации транспорта

Активные комплектации поколения (trims), поиск и пагинация. По умолчанию автомобили; vehicle_type=motorcycle — мотоциклы.

  • Без vehicle_type возвращаются автомобили; motorcycle / 2 выбирает мотоциклы. Сохраняйте тип на каждом шаге.
  • ID поколения берите из /generations/{model_id}. Trim — комплектация. Одно поколение не доказывает совместимость variant и trim.
  • 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/trims/{generation_id}
curl -g "https://api.auctionsapi.com/trims/301?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ПримерыПример
{2 keys
"data": [1 item
0: {6 keys
"id": 401
"name": "Example trim"
"brand_id": 101
"model_id": 201
"generation_id": 301
"vehicle_type": 1
}
]
"meta": {8 keys}
}

Получите доступ к API

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

У меня есть ключ