Техническая документация Link Auto API

Link Auto API

Универсальный API для мгновенной оценки автомобилей в Узбекистане. Наше решение позволяет партнерам интегрировать профессиональную экспертизу в свои продукты для автоматизации принятия решений.

Прозрачность (Glass Box Standard)

Авторизация

Безопасность API обеспечивается через проверку статических ключей. Используйте заголовок X-API-Key для аутентификации каждого запроса.

Authorization: X-API-Key <YOUR_API_KEY>

Конфиденциальность данных

Платформа не требует передачи персональных данных клиентов (ПДн). Расчеты выполняются исключительно на базе технических параметров актива.

Методология (Glass Box)

Сбор и обработка данных

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

Показатели точности (Chevrolet)

Для бренда Chevrolet модель демонстрирует наиболее высокие показатели точности. Коэффициент детерминации (R2 Score) составляет 0.947, что означает объяснение почти 95% вариативности цен. Среднее отклонение (MAPE) зафиксировано на уровне 7.5%, что подтверждает высокую надежность прогноза.

0.947 R2 Score

7.5% MAPE

860.1 MAE

Влияние факторов (Feature Importance)

Пробег (mileage) 19.5%

Год выпуска (release_year) 19.4%

Название автомобиля (car_name) 18.0%

Год объявления 8.3%

Регион 7.2%

Объем двигателя 6.9%

Месяц объявления 6.2%

Цвет 4.5%

Состояние 3.1%

Тип кузова 2.9%

Тип топлива 2.5%

Коробка передач 1.6%

На графике представлены 12 ключевых факторов, оказывающих наибольшее влияние на оценку стоимости.

POST

/api/predict/auto

Основной метод для оценки транспортных средств. Возвращает текущую рыночную стоимость, доверительные интервалы и данные для проверки на аномалии (анти-фрод).

Параметры запроса

Параметр	Тип	Обяз.	Допустимые значения
brand	string	ДА	Chevrolet Ravon Daewoo Toyota Hyundai Kia и другие иномарки Синие = отечественные (Chevrolet/Ravon/Daewoo), серые = иномарки
model	string	ДА	Cobalt Gentra Nexia III Nexia II Nexia Spark Malibu II Malibu I Malibu Tracker II Tracker Damas Matiz Lacetti Captiva Captiva I Captiva II Captiva III Captiva IV Equinox Orlando Cruze Monza Onix Labo Tahoe Suburban TrailBlazer Traverse Silverado Camaro Bolt EV Trax Aveo Epica Tacuma Lacetti Leganza Magnus Lanos Nubira Espero Tico Kalina Vesta SW Transporter Rio Optima Stinger Bora C-HR G-class R2 R3 R4 J7 Seeker Bestune T55 Benben E-Star Menlo Song Plus Champion Tang Ev UNI-V EU5 Velite 6 e2 Optra Prince Sport Nexia I 523
year	integer	ДА	Год выпуска автомобиля, напр. `2018`
mileage	integer	ДА	Пробег в километрах, напр. `85000`
engine_volume	float	ДА	Объём двигателя в литрах, напр. `1.5`
color	string	ДА	Oq Qora Kumush Kulrang Ko'k Jigarrang Bejeviy Asfalt Boshqa
transmission	string	ДА	Mexanik Avtomat
fuel	string	ДА	Benzin Gaz/Benzin Dizel Gibrid Elektro Boshqa
body_type	string	ДА	Sedan Xetchbek Yo'ltanlamas Universal Miniven Kupe Pikap Kabriolet Boshqa
condition	string	ДА	A'lo Yaxshi O'rtacha Remont talab
state	string	ДА	Toshkent shahri Toshkent Viloyati Samarqand Viloyati Farg'ona Viloyati Andijon Viloyati Namangan Viloyati Buxoro Viloyati Navoiy Viloyati Qashqadaryo Viloyati Surxondaryo Viloyati Xorazm Viloyati Sirdaryo Viloyati Jizzax Viloyati Qoraqalpog'iston Respublikasi
ownership	string	НЕТ	Xususiy Biznes По умолчанию: `Xususiy`
owners_count	integer	НЕТ	Количество владельцев. По умолчанию: `1`
month	integer	НЕТ	Месяц размещения объявления (1–12). По умолчанию: текущий месяц.
features	array	НЕТ	Konditsioner Xavfsizlik tizimi Parctronik Rastamojka qilingan Elektron oynalar Elektron ko'zgular Передаётся как массив строк. По умолчанию: `[]`

cURL Запрос

curl -X POST https://asint.uz/api/predict/auto \

  -H "Content-Type: application/json" \

  -H "X-API-Key: YOUR_API_KEY" \

  -d '{

    "transmission": "manual",

    "mileage": 85000,

    "release_year": 2018,

    "engine_volume": 1.5,

    "year": 2025,

    "brand": "Chevrolet",

    "owners_count": 2,

    "model": "Nexia 3",

    "body_type": "Sedan",

    "fuel": "Petrol",

    "item_type": "business",

    "condition": "average",

    "color": "White",

    "state": "Tashkent",

    "features": ["Air_Conditioner", "Power_Windows"]

  }'

Python (requests)

                            import requests

                            url = "https://asint.uz/api/predict/auto"

                            headers = {

                                "Content-Type": "application/json",

                                "X-API-Key": 'API-KEY'

                            }

                            data = {

                                "transmission": "manual",

                                "mileage": 200000,

                                "release_year": 2015,

                                "engine_volume": 1.2,

                                "year": 2025,

                                "brand": "Chevrolet",

                                "owners_count": 1,

                                "model": "Spark",

                                "body_type": "Sedan",

                                "fuel": "diesel",

                                "item_type": "business",

                                "condition": "average",

                                "color": "White",

                                "state": "Tashkent2",

                                "features": ["Air_Conditioner", "Security_System", "Parking_Sensors", "Customs_Cleared", "Power_Windows", "Power_Mirrors"]

                            }

                            response = requests.post(url, headers=headers, json=data, timeout=10)

                            print(response.json())

Коды ответов и ошибок

Код	Описание	Причина / Решение
200 OK	Успешный запрос	Оценка успешно произведена и возвращена в JSON.
400 Bad Request	Неверные параметры	Отсутствуют обязательные поля (напр. `release_year`) или неверный формат данных.
401 Unauthorized	Ошибка авторизации	Ключ `X-API-Key` не указан или является невалидным.
403 Forbidden	Доступ запрещен	Ваш API ключ деактивирован или у вас нет прав на этот метод.
429 Too Many Requests	Лимит превышен	Превышен квотный лимит запросов в секунду/минуту.
500 Server Error	Внутренняя ошибка	Ошибка на стороне сервера. Обратитесь в техподдержку.