Главная → Документация → Фотографии автомобиля

Фотографии автомобиля

Фотографии автомобиля из открытых объявлений о продаже - по государственному регистрационному номеру. Ответ содержит прямые ссылки на снимки, пригодные для показа в вашем интерфейсе или для скачивания.

Хост api.avtovincod.ru Метод GET Формат JSON Авторизация Bearer Ответ до 60 сек

Аутентификация

Единый API-токен для всех API выдаётся сразу после регистрации в личном кабинете. Передавайте его в заголовке:

Authorization: Bearer ВАШ_ТОКЕН

Эндпоинт

GET https://api.avtovincod.ru/nomerogram?plate=А007ОК178
Authorization: Bearer ВАШ_ТОКЕН

Параметр	Описание
plate	Основной параметр. Госномер: буквы АВЕКМНОРСТУХ и цифры, 6-9 символов (например А007ОК178). Латинские буквы-двойники нормализуются автоматически.
vin	Альтернатива plate: VIN, 11-17 символов латиницей. Поиск по VIN выполняется только по накопленному кэшу фотографий (сбор у источника - по госномеру); если в кэше снимков нет - вернётся «не найдено» без списания.
force_refresh=1	Необязательный. Игнорировать кэш ответов (тарифицируется как обычный запрос).

Пример успешного ответа

{
  "success": 1,
  "regNumber": "А007ОК178",
  "totalPhotos": 4,
  "photos": [
    "https://cdn1.example.com/photo/f3a9c1d84b27e650a9312c74.jpg",
    "https://cdn1.example.com/photo/0b74e2a9d1c8f35617d940ab.jpg",
    "https://cdn2.example.com/photo/52c7d90e1a4b83f62e08c1d5.jpg",
    "https://img.example.net/auto/9e12ab74c3d05f8846b217e0.jpg"
  ]
}

Поле	Описание
regNumber	Госномер из запроса (нормализованный). При поиске по VIN вместо него возвращается поле `vin`.
totalPhotos	Количество ссылок в ответе. Может быть 0: источник обработал запрос, но объявлений со снимками этого автомобиля не нашлось - такой ответ считается выполненным.
photos	Массив прямых ссылок на фотографии (JPEG), без дублей, в порядке публикаций. Ссылки ведут на внешние хранилища и со временем могут становиться недоступными.

Фотографии не найдены и запрос не был обработан источником - ответ {"success": 0, "status": "not_found"} (HTTP 200, запрос не тарифицируется).

Сбор снимков выполняется на стороне источника: ответ может занимать до 45 секунд, закладывайте таймаут клиента 60 секунд. Повторные обращения по тому же автомобилю в пределах срока жизни кэша возвращают уже собранный набор фотографий.

Коды ошибок

HTTP · code	Что означает
400 · PLATE_INVALID / VIN_INVALID / NO_INPUT	Неверный формат идентификатора или он не передан.
401 · NO_TOKEN / TOKEN_INVALID	Токен не передан, неверен или деактивирован. Возьмите актуальный в кабинете.
402 · INSUFFICIENT_BALANCE	Недостаточно средств. Пополните баланс в кабинете (раздел «Платежи»).
403 · NOT_ALLOWED / API_DISABLED	API не подключён для токена или временно отключён. Запросите доступ в кабинете.
403 · IP_NOT_ALLOWED	IP не входит в ваш белый список (если он настроен).
429 · RATE_LIMIT / RATE_LIMIT_IP	Превышена частота запросов в минуту. Повторите через минуту.
503 · SERVICE_UNAVAILABLE	Источник временно недоступен. Повторите позже, запрос не тарифицирован.

Пример на cURL

curl -s --max-time 60 "https://api.avtovincod.ru/nomerogram?plate=А007ОК178" \\
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Тарификация

Списание происходит только при успешной обработке запроса источником (success: 1), в том числе когда набор снимков отдан из накопленного кэша фотографий. Ответ «не найдено» и ошибки не тарифицируются. Актуальная цена и баланс доступны в личном кабинете.