General

All API requests use POST method. Data is sent in JSON format (raw body).

Response format

All responses follow a unified JSON structure:

Token send in headers

{
  "status": "OK | err",
  "msg": "string (optional)",
  "data": {}
}

Success (HTTP 200)

{
  "status": "OK",
  "data": {}
}

Error

{
  "status": "err",
  "msg": "Error description"
}

Авторизація
/api/user/auth

• string phone ^* — User phone
• int verify_code ^* — Code in sms

verify_code потрібен лише для автентифікації вже існуючого користувача. Якщо verify_code не передано, API розпочне процес реєстрації та надішле код підтвердження через SMS.

У разі успіху API повертає токен або код підтвердження, який використовується для всіх автентифікованих запитів.

Оновити профіль
/api/user/update

Потрібен токен

• string email ^* — User eemail
• string name ^* — User name
• int dt_birthday — unix date
• int id_city — id_city
• int id_state — id_state
• string call_from — example 09:00
• string call_to — example 20:00

Оновити користувача налаштування
/api/user/settings/update

Потрібен токен

• int allow_chat ^* — Дозволити покупцям звязуватись зі мною через чат
• int allow_promotional_notifications ^* — Отримувати розсилки про оновлення,акції,конкурси
• int allow_message_notifications ^* — Отримувати сповіщення про нові повідомлення
• int allow_favorite_price_drop_notifications ^* — Сповіщення про зниження цін на оголошення Обраного

Провірка токена
/api/user/token/check

Потрібен токен

Улюблені автомобілі користувача
/api/user/car/favorite

Потрібен токен

Вихід
/api/user/logout

Потрібен токен

Додати фото профілю користувача
/api/user/profile/image

Потрібен токен

• array img ^* — image/image

Повернути контакти користувача
/api/user/phone/show

Потрібен токен

• string hash ^* — hash користувача
• int id_car — id автомобіля при перегляді

Отримати статистику автомобіля користувача
/api/user/car/statistic

Потрібен токен

• int id_car ^* — id автомобіля при перегляді
• int date_from — період від
• int date_to — період до

Додати відгук до користувача
/api/user/review/add

Потрібен токен

• string hash ^* — hash користувача
• int rating ^* — Рейтинг 1-5
• string comment — коментар
• int rating_description_accuracy - Актуальність опису та фото 1-5
• int rating_staff_competence - Компетентність представників салону 1-5
• int rating_purchase_clarity - Зрозумілість умов покупки та додаткових витрат 1-5
• int rating_assistance - Допомога під час вибору авто 1-5
• int rating_purchase_process - Зручність та швидкість оформлення покупки 1-5
• array int tags[] — Теги відгуків ( 1,3,6 )

Повернути відгуки до користувача
/api/user/review

• string hash ^* — hash користувача

Повернути мої відгуки
/api/user/review/my

Потрібен токен

Видалити відгук
/api/user/review/remove

Потрібен токен

• int id_review ^* — id відгука

Додати зображення до відгуку
/api/user/review/add/image

Потрібен токен

Method from-data

• string id_review ^* — id відгука
• array img[] ^* — зображення

Видалити зображення профілю
/api/user/profile/image/delete

Потрібен токен

Видалити користувача
/api/user/delete

Потрібен токен

Інформація про профіль
/api/user/me

Потрібен токен

Автомобілі користувача
/api/user/car

Потрібен токен

• int id_status — id статусів авто
• string sort — Сортування: 'price', 'price_desc', 'year', 'year_desc', 'mileage', 'mileage_desc', 'new', 'old'

Повернути авто одне користувача
/api/user/car/single

Потрібен токен

• int id^* — id авто

Інформація про продавця
/api/user/owner

• string hash^* — hash користувача

Категорія транспортного засобу
/api/filter/category

No parameters required.

Бренд авто
/api/filter/brand

• int id_category — Категорія транспортного засобу ID

Модель авто
/api/filter/model

• int id_brand ^* — Brand ID

Тип кузова
/api/filter/body

• int id_category ^* — Категорія транспортного засобу ID

Покоління авто
/api/filter/generation

• int id_model ^* — Модель ID

Модифікація авто
/api/filter/modification

• int id_generation ^* — Generation ID

Область
/api/filter/state

No parameters required.

Міста
/api/filter/city

• id_state ^* — Region ID

Статус автомобіля
/api/filter/status

No parameters required.

Теги відгуків
/api/filter/review_tags

No parameters required.

Додаткові фільтра
/api/filter/additional

No parameters required.

Додати автомобіль (розширено)
/api/car/create

Потрібен токен

• int id_category ^* — ID категорії
• int id_brand ^* — ID марки
• int id_model ^* — ID моделі
• int price ^* — Ціна ($ / валюта)
• string price_currency ^* — Валюта (uah, usd, eur)
• int mileage ^* — Пробіг (км)
• int year ^* — Рік випуску
• int id_body ^* — ID типу кузова
• int id_fuel ^* — ID типу пального
• int id_drive ^* — ID типу приводу
• int id_gearbox ^* — ID типу коробки передач
• int id_color ^* — ID кольору
• int id_state ^* — ID технічного стану
• int id_city ^* — ID міста

Загальна інформація

• string vin — VIN-код
• string registration_number — Державний номер
• string description — Опис автомобіля
• int engine_volume — Об'єм двигуна (см³)
• int engine_power — Потужність двигуна (к.с./кВт)
• int type_seller — Тип продавця (0/1)

Власність та стан

• int count_doors — Кількість дверей
• int count_owner — Кількість власників
• int is_installments — Доступна розстрочка (0/1)
• int is_not_cleared — Нерозмитнений (0/1)
• int is_owner — Продавець є власником (0/1)
• int is_dont_call — Не телефонувати (0/1)
• int is_negotiable — Можливий торг (0/1)
• int is_exchange_car — Можливий обмін (0/1)
• int is_usa — Імпортований зі США (0/1)
• int is_credit — Автомобіль придбано в кредит (0/1)

Характеристики автомобіля

• int id_driven_from — Звідки пригнано (країна/регіон)
• int id_generation — Покоління
• int id_modification — Модифікація

Комфорт та салон

• int id_air_conditioners — Кондиціонер
• int id_headlight_types — Тип фар
• int id_interior_colors — Колір салону
• int id_interior_materials — Матеріал салону
• int id_power_steering_types — Тип підсилювача керма
• int id_power_windows — Електросклопідйомники

Сидіння та регулювання

• int id_seat_heating_options — Підігрів сидінь
• int id_seat_memory_options — Пам'ять сидінь
• int id_seat_ventilation_options — Вентиляція сидінь
• int id_steering_adjustments — Регулювання керма

Запасне колесо та колеса

• int id_spare_wheel_types — Тип запасного колеса

Інше

• int is_under_warranty — На гарантії (0/1)
• int dtp — 0 - невідомо, 1 - не був у ДТП, 2 - був у ДТП
• int gbo — Покоління ГБО
• int fuel_consumption_city — Витрата пального у місті (л/100 км)
• int fuel_consumption_highway — Витрата пального на трасі (л/100 км)
• int fuel_consumption_combined — Змішана витрата пального (л/100 км)
• string package_name — Назва комплектації
• int is_not_drivable — Не на ходу (0/1)

Оновлення автомобіля (розширене)
/api/car/update

Потрібен токен

• int id ^* — ID автомобіля
• int id_category ^* — ID категорії
• int id_brand ^* — ID марки
• int id_model ^* — ID моделі
• int price ^* — Ціна ($ / валюта)
• string price_currency ^* — Валюта (uah, usd, eur)
• int mileage ^* — Пробіг (км)
• int year ^* — Рік випуску
• int id_body ^* — ID типу кузова
• int id_fuel ^* — ID типу пального
• int id_drive ^* — ID типу приводу
• int id_gearbox ^* — ID типу коробки передач
• int id_color ^* — ID кольору
• int id_state ^* — ID технічного стану
• int id_city ^* — ID міста

Загальна інформація

• string vin — VIN-код
• string registration_number — Державний номер
• string description — Опис автомобіля
• int engine_volume — Об'єм двигуна (см³)
• int engine_power — Потужність двигуна (к.с./кВт)
• int type_seller — Тип продавця (0/1)

Власність та стан

• int count_doors — Кількість дверей
• int count_owner — Кількість власників
• int is_installments — Доступна розстрочка (0/1)
• int is_not_cleared — Нерозмитнений (0/1)
• int is_owner — Продавець є власником (0/1)
• int is_dont_call — Не телефонувати (0/1)
• int is_negotiable — Можливий торг (0/1)
• int is_exchange_car — Можливий обмін (0/1)
• int is_usa — Імпортований зі США (0/1)
• int is_credit — Автомобіль придбано в кредит (0/1)

Характеристики автомобіля

• int id_driven_from — Звідки пригнано (країна/регіон)
• int id_generation — Покоління
• int id_modification — Модифікація

Комфорт та салон

• int id_air_conditioners — Кондиціонер
• int id_headlight_types — Тип фар
• int id_interior_colors — Колір салону
• int id_interior_materials — Матеріал салону
• int id_power_steering_types — Тип підсилювача керма
• int id_power_windows — Електросклопідйомники

Сидіння та регулювання

• int id_seat_heating_options — Підігрів сидінь
• int id_seat_memory_options — Пам'ять сидінь
• int id_seat_ventilation_options — Вентиляція сидінь
• int id_steering_adjustments — Регулювання керма

Запасне колесо та колеса

• int id_spare_wheel_types — Тип запасного колеса

Інше

• int is_under_warranty — На гарантії (0/1)
• int dtp — 0 - невідомо, 1 - не був у ДТП, 2 - був у ДТП
• int gbo — Покоління ГБО
• int fuel_consumption_city — Витрата пального у місті (л/100 км)
• int fuel_consumption_highway — Витрата пального на трасі (л/100 км)
• int fuel_consumption_combined — Змішана витрата пального (л/100 км)
• string package_name — Назва комплектації
• int is_not_drivable — Не на ходу (0/1)

Додати зображення
/api/car/img

Потрібен токен

• int id_car ^* — ID автомобіля
• array img ^* — Зображення 1 за раз

Видалити зображення
/api/car/img/delete

Потрібен токен

• int id_car ^* — ID автомобіля
• string key ^* — Ключ зображення

Сортування зображень
/api/car/img/sorting

Потрібен токен

• int id_car ^* — ID автомобіля
• array keys ^* — Ключі зображень у порядкі сортування

Оновити зображеня
/api/car/img/update

Потрібен токен

method form_data

• int id_car ^* — ID автомобіля
• string img_key ^* — Ключ зображення якого потрібно оновити
• array img ^* — Нове зображення

Інформація про автомобіль
/api/car/single

Видалити автомобіль
/api/car/delete

Потрібен токен

• int id^* — ID автомобіля

Відновити видалене авто
/api/car/restore

Потрібен токен

• int id_car^* — ID автомобіля

Додати в обране
/api/car/favorite/add

Потрібен токен

• int id_car^* — ID автомобіля

Видалити з обраного
/api/car/favorite/remove

Потрібен токен

• int id_car^* — ID автомобіля

Чати користувача
/api/user/chat/list

Потрібен токен

Чат по конкретному автомобілю
/api/user/chat/list/single

Потрібен токен

• int id_car^* — ID автомобіля

Додати запис до журналу пошуку в реєстрі
/api/logs/car/search

• int ip ^* — IP-адреса
• int id_user — ID користувача
• string vin — VIN-код
• string state_number — Державний номер

Блог пошук
/api/blog/list

• int id_category — Категорія блогу
• int page — Сторінка

Блог одиночний
/api/blog/single

• int id — ID блогу

Статуси блогу
/api/blog/status

Пошук автомобілів
/api/car/search

• int id_category — ID категорії
• int id_generation — ID покоління
• int id_modification — ID модифікації
• int id_body — ID типу кузова
• int id_state — ID технічного стану
• int id_city — ID міста
• int id_brand — ID марки (мін. 0)
• int id_model — ID моделі (мін. 0)
• int year_from — Рік випуску від (мін. 1920)
• int year_to — Рік випуску до (мін. 1920, макс. поточний рік)
• int id_air_conditioners — ID типу кондиціонера
• int id_headlight_types — ID типу фар
• int id_interior_colors — ID кольору салону
• int id_interior_materials — ID матеріалу салону
• int id_power_steering_types — ID типу підсилювача керма
• int id_power_windows — ID електросклопідйомників
• int id_seat_heating_options — ID підігріву сидінь
• int id_seat_memory_options — ID пам'яті сидінь
• int id_seat_ventilation_options — ID вентиляції сидінь
• int id_spare_wheel_types — ID типу запасного колеса
• int id_steering_adjustments — ID регулювання керма
• int count_owner_from — Кількість власників від (мін. 1)
• int count_owner_to — Кількість власників до (макс. 50)
• int count_doors_from — Кількість дверей від (мін. 1)
• int count_doors_to — Кількість дверей до (макс. 10)
• int mileage_from — Пробіг від (мін. 0)
• int mileage_to — Пробіг до (макс. 10000)
• array id_fuels — ID типів пального
• array id_gearboxs — ID типів коробки передач
• array id_drives — ID типів приводу
• array id_colors — ID кольорів
• array id_driven_froms — ID країн/регіонів, звідки пригнано
• array car_group — Групи складних фільтрів (AND всередині групи, OR між групами)
• string price_currency (uah, usd, eur) — Валюта ціни
• int price_from — Мінімальна ціна
• int price_to — Максимальна ціна
• string vin — VIN-код (17 символів)
• int page — Номер сторінки (0–999)
• string sort — enum ('price','price_desc','dt_change_desc') Сортування
• int is_negotiable — Можливий торг
• int is_exchange_car — Можливий обмін
• int engine_volume_from — Обєм двигуна від
• int engine_volume_to — Обєм двигуна до
• string user_hash — hash користувача

Приклад запиту

{
    "price_currency":"uah",
    "id_model":3,
    "id_brand":2,
    "year_from":1990,
    "year_to":2024,
    "id_fuels":[1,2],
    "id_gearboxs":[1,2],
    "id_drives":[1,3],
    "id_colors":[1],
    "id_driven_froms":[4,1],
    "car_group":[
        {
            "id_brand":1,
            "id_model":2,
            "id_body":4,
            "year_from":1995,
            "year_to":1999
        },
        {
            "id_brand":1,
            "id_model":2,
            "id_body":4,
            "year_from":2015,
            "year_to":2025
        }
    ]
}