Техническая документация Link Auto API
Link Auto API
Универсальный API для мгновенной оценки автомобилей в Узбекистане. Наше решение позволяет партнерам интегрировать профессиональную экспертизу в свои продукты для автоматизации принятия решений.
Авторизация
Безопасность API обеспечивается через проверку статических ключей. Используйте заголовок X-API-Key для аутентификации каждого запроса.
Конфиденциальность данных
Платформа не требует передачи персональных данных клиентов (ПДн). Расчеты выполняются исключительно на базе технических параметров актива.
Получить ключ самостоятельно
Войдите на asint.uz → Настройки → Разработчикам и создайте ключ dk_….
Первые 3 запроса бесплатно, далее 15 000 сум за запрос с баланса (см. полный запрос).
Организациям — отдельный аккаунт со своими сотрудниками, общим балансом и ключами организации:
заявка на странице API.
Методология (Glass Box)
Сбор и обработка данных
Наша система ежедневно агрегирует данные из крупнейших классифайдов Узбекистана. Процесс включает многоэтапную очистку: удаление дублей, фильтрацию выбросов и нормализацию параметров, формируя качественную выборку для обучения ансамблевых моделей.
Показатели точности (Chevrolet)
Для бренда Chevrolet модель демонстрирует наиболее высокие показатели точности. Коэффициент детерминации (R2 Score) составляет 0.947, что означает объяснение почти 95% вариативности цен. Среднее отклонение (MAPE) зафиксировано на уровне 7.5%, что подтверждает высокую надежность прогноза.
Влияние факторов (Feature Importance)
На графике представлены 12 ключевых факторов, оказывающих наибольшее влияние на оценку стоимости.
/service/predict/auto
Основной метод для оценки транспортных средств. Возвращает текущую рыночную стоимость, доверительные интервалы и данные для проверки на аномалии (анти-фрод).
cURL Запрос
-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)
url = "https://asint.uz/service/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())
/service/v1/auto
Полный запрос для автомобиля: один вызов — всё сразу. В ответе оценка стоимости (регрессия, диапазон, факторы),
прогноз цены перепродажи на 3/6/9 месяцев, если модель покрыта (/forecast/auto) и готовый отчёт — расширенный (многостраничный) или краткий (одна страница), в PDF или HTML.
Поля автомобиля — те же, что в /predict/auto.
Дополнительные поля тела запроса
| Ключ | Тип | Описание |
|---|---|---|
| report_type | string | advanced (по умолчанию) — полный отчёт; simple — краткая сводка на одной странице |
| format | string | pdf (по умолчанию, в ответе base64) или html (текст) |
| lang | string | Язык отчёта: en (по умолчанию), ru, uz |
Ответ (JSON)
| Ключ | Описание |
|---|---|
| request | Что стоил этот запрос: free (бесплатный ли), charged (сум списано), free_left (осталось бесплатных), balance (баланс). Для ключей организаций request_id пуст — списаний нет. |
| valuation | Тот же ответ, что у /predict/auto: predicted_price, price_range, warnings… |
| forecast | Тот же ответ, что у /forecast/auto, или null, если для объекта прогноза нет |
| report | report_type, format, media_type, filename, encoding (base64 для PDF, utf-8 для HTML) и content — сам файл |
Стоимость и бесплатные запросы
Ключ вида dk_… создаёт сам пользователь в личном кабинете asint.uz (Настройки → Разработчикам).
Первые 3 запроса на аккаунт — бесплатно (на квартиры и авто вместе), дальше 15 000 сум за запрос
с баланса аккаунта; пополнение через Click. Если запрос завершился ошибкой, деньги и бесплатный запрос возвращаются автоматически.
Ключи организаций (договор) за каждый вызов не тарифицируются.
cURL Запрос
-H "Content-Type: application/json" \
-H "X-API-Key: dk_YOUR_KEY" \
-d '{
"brand": "Chevrolet", "model": "Cobalt", "year": 2019,
"mileage": 84000, "engine_volume": 1.5, "color": "white",
"transmission": "at", "fuel": "petrol", "body_type": "sedan",
"condition": "good", "state": "tashkent",
"report_type": "simple", "format": "html", "lang": "ru"
}'
Python: сохранить отчёт в файл
r = requests.post("https://asint.uz/service/v1/auto",
headers={"X-API-Key": "dk_YOUR_KEY"}, json=data)
r.raise_for_status()
body = r.json()
print(body["valuation"]["predicted_price"], body["request"])
rep = body["report"]
data_bytes = base64.b64decode(rep["content"]) if rep["encoding"] == "base64" else rep["content"].encode()
open(rep["filename"] or "report", "wb").write(data_bytes)
Только отчёт: POST /service/report/auto
То же тело запроса (с report_type, format, lang), но в ответ приходит сам файл
(application/pdf или text/html), а оценка — в заголовках X-Predicted-Price и X-Price-Range.
Доступно для ключей, принятых /predict (корпоративные и служебные); ключи dk_… используют /service/v1/auto.
Коды ответов и ошибок
| Код | Описание | Причина / Решение |
|---|---|---|
| 200 OK | Успешный запрос | Оценка успешно произведена и возвращена в JSON. |
| 400 Bad Request | Неверные параметры | Отсутствуют обязательные поля (напр. release_year) или неверный формат данных. |
| 401 Unauthorized | Ошибка авторизации | Ключ X-API-Key не указан или является невалидным. |
| 403 Forbidden | Доступ запрещен | Ваш API ключ деактивирован, у вас нет прав на этот метод, либо аккаунт принадлежит организации — используйте ключ организации. |
| 402 Payment Required | Нет средств | Бесплатные запросы закончились, а баланс меньше 15 000 сум — пополните его в личном кабинете. |
| 422 Unprocessable | Недопустимое значение | Нет обязательного поля или значение не поддерживается (напр. неверный report_type или format). Запрос не тарифицируется. |
| 502 / 503 / 504 | Сервис отчётов или биллинга недоступен | Повторите позже; для 504 попробуйте format: "html" или report_type: "simple". Списанное возвращается автоматически. |
| 429 Too Many Requests | Лимит превышен | Превышен квотный лимит запросов в секунду/минуту. |
| 500 Server Error | Внутренняя ошибка | Ошибка на стороне сервера. Обратитесь в техподдержку. |