Все релизы
Changelog

Дополнение API v2: студийные наборы, 360° спины и сцены образа жизни

Новое с дополнением API v2: студийные группы, полные 360° вращения и сцены образа жизни — те же ключи, те же вызовы, плюс новые опции изображений. И более быстрая, справедливая очередь для новых изображений.

28 сентября 2026 года13 изменений

Добавлено

  • Дополнение к API v2 для ключей с доступом v2 (access в /api/me: v2 или all). Автомобили с дополнительными изображениями перечисляют groups на конечной точке комплектации рядом с views.
  • Группы студии hero, steered, extra и drone: …/{trim}/{group} перечисляет изображения, …/{trim}/{group}/{image} разрешает одно.
  • 360° вращения в трёх кольцах (eye_level, low, high): …/{trim}/360 перечисляет их, …/{trim}/360/{ring} возвращает каждый кадр со своим подписанным image_url.
  • Сцены из жизни: …/{trim}/lifestyle, …/lifestyle/{scene} и …/lifestyle/{scene}/{image}
  • Дополнительные параметры изображений: lights=on, background (белый, прозрачный или hex), цвет краски color в формате hex (например, c8102e), windows=dark, plate=blank|logo, fit=contain|cover, size (2k … thumb) и hotspots=true (точки интереса для интерактивных просмотров).
  • Новые ошибки для дополнения: G23, M24, L26, W28, N29, N30, O31, B32 — все перечислены в /api/errornotes
  • /api/me теперь показывает access (v1, v2, all) и queue_priority; с дополнительным также раздел addon (форматы, группы, опции, бренды, логотип номерного знака).
  • С помощью дополнения, /api/search находит машины дополнения, /api/getall перечисляет их с их groups, а /colors, /features и /all машины описывают её варианты дополнения (any_hex_color, features.addon).
  • /api/options, /api/sizes и /api/views добавляют раздел addon: опции дополнительного с их значениями, пресеты size и группы.
  • Все также работает по стабильному id: /api/id/{id}/{group}/{image}, /api/id/{id}/360/{ring}, /api/id/{id}/lifestyle/{scene}/{image}

Улучшенный

  • Новые изображения создаются в честной очереди: планы с более высоким приоритетом идут первыми, а идентичные запросы, поступающие одновременно, создаются только один раз.
  • Перекрашивание нескольких красок одного вида одновременно создаёт маску краски один раз, а не для каждого цвета — первые загрузки под нагрузкой происходят намного быстрее и надёжнее.
  • При очень высокой нагрузке URL изображения теперь отвечает 503 busy с Retry-After вместо тайм-аута. Ответы содержат X-Cache и X-Queue-Wait-Ms

Хотите эти изображения для вашего инвентаря?

Скажите, какие автомобили вы размещаете, и мы отправим вам реальные примеры из вашего собственного запаса.

Понравилось?

Добавьте в качестве предпочтительного источника на Google