Asint | Link Auto API
API v1.0 Online

Link Auto API

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

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

Авторизация

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

Authorization: X-API-Key <YOUR_API_KEY>

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

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

Получить ключ самостоятельно

Войдите на asint.uz → Настройки → Разработчикам и создайте ключ dk_…. Первые 3 запроса бесплатно, далее 15 000 сум за запрос с баланса (см. полный запрос). Организациям — отдельный аккаунт со своими сотрудниками, общим балансом и ключами организации: заявка на странице API.

Методология (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

/service/predict/auto

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

cURL Запрос

curl -X POST https://asint.uz/service/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/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())
POST

/service/v1/auto

Полный запрос для автомобиля: один вызов — всё сразу. В ответе оценка стоимости (регрессия, диапазон, факторы), прогноз цены перепродажи на 3/6/9 месяцев, если модель покрыта (/forecast/auto) и готовый отчёт — расширенный (многостраничный) или краткий (одна страница), в PDF или HTML. Поля автомобиля — те же, что в /predict/auto.

Дополнительные поля тела запроса

КлючТипОписание
report_typestringadvanced (по умолчанию) — полный отчёт; simple — краткая сводка на одной странице
formatstringpdf (по умолчанию, в ответе base64) или html (текст)
langstringЯзык отчёта: en (по умолчанию), ru, uz

Ответ (JSON)

КлючОписание
requestЧто стоил этот запрос: free (бесплатный ли), charged (сум списано), free_left (осталось бесплатных), balance (баланс). Для ключей организаций request_id пуст — списаний нет.
valuationТот же ответ, что у /predict/auto: predicted_price, price_range, warnings…
forecastТот же ответ, что у /forecast/auto, или null, если для объекта прогноза нет
reportreport_type, format, media_type, filename, encoding (base64 для PDF, utf-8 для HTML) и content — сам файл

Стоимость и бесплатные запросы

Ключ вида dk_… создаёт сам пользователь в личном кабинете asint.uz (Настройки → Разработчикам). Первые 3 запроса на аккаунт — бесплатно (на квартиры и авто вместе), дальше 15 000 сум за запрос с баланса аккаунта; пополнение через Click. Если запрос завершился ошибкой, деньги и бесплатный запрос возвращаются автоматически. Ключи организаций (договор) за каждый вызов не тарифицируются.

cURL Запрос

curl -X POST https://asint.uz/service/v1/auto \
  -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: сохранить отчёт в файл

import base64, requests

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 Внутренняя ошибка Ошибка на стороне сервера. Обратитесь в техподдержку.