API Документация

Полное описание REST API для работы с платформой AutoTriumph

Базовый URL

http://api.your-proff-manager.ru

Авторизация

Большинство endpoints требуют авторизации через JWT токен. Получите токен через эндпоинт авторизации.

POST /admin/auth/login

Авторизация администратора

{
  "login": "admin",
  "password": "password"
}

Ответ:

{
  "token": "jwt_token_here",
  "admin": { "id": 1, "login": "admin" }
}

POST /admin/auth/users/register

Регистрация нового пользователя

{
  "email": "user@example.com",
  "password": "password123",
  "firstName": "Иван",
  "lastName": "Иванов",
  "phone": "+79991234567"
}

POST /admin/auth/users/login

Авторизация пользователя

{
  "email": "user@example.com",
  "password": "password123"
}

Используйте полученный токен в заголовке запросов:

Authorization: Bearer {token}

Управление Ботами

GET /admin/bots

Получить список ботов

Query параметры: search, status, limit, offset, orderBy, orderDirection

POST /admin/bots

Создать нового бота

{
  "name": "Мой бот",
  "status": "active",
  "generalSettings": {
    "channel": "whatsapp",
    "phoneNumber": "+79991234567"
  }
}

GET /admin/bots/:botId

Получить информацию о боте

PUT /admin/bots/:botId

Обновить настройки бота

DELETE /admin/bots/:botId

Удалить бота

Управление Диалогами

GET /admin/dialogs

Получить список диалогов

Query параметры: botId, status, externalClientId, limit, offset

POST /admin/dialogs

Создать новый диалог

{
  "botId": 1,
  "externalClientId": "user123",
  "title": "Новый диалог",
  "status": "open"
}

GET /admin/dialogs/:dialogId/messages

Получить сообщения диалога

POST /admin/dialogs/:dialogId/messages

Отправить сообщение в диалог

{
  "body": "Привет!",
  "attachments": []
}

Управление Клиентами

GET /admin/clients

Получить список клиентов

Query параметры: search, status, vip, sortBy, sortOrder, limit, offset

GET /admin/clients/:id

Получить информацию о клиенте

PUT /admin/clients/:id

Обновить данные клиента

Управление Автомобилями

GET /admin/vehicles

Получить список автомобилей

POST /admin/vehicles

Добавить новый автомобиль

{
  "brand": "Mercedes-Benz",
  "seats": 4,
  "hours_weekday": 4,
  "hours_weekend": 6,
  "price_per_hour_min": 2500,
  "price_per_hour_max": 3000
}

PUT /admin/vehicles/:id

Обновить данные автомобиля

Widget API (Публичный)

Эти endpoints доступны без авторизации для интеграции виджета на сайт

GET /api/widget/init?botId={botId}

Получить конфигурацию виджета

POST /api/widget/message

Отправить сообщение от пользователя

{
  "botId": 1,
  "clientId": "visitor123",
  "message": "Привет!",
  "metadata": {}
}

GET /api/widget/dialogs?externalClientId={visitorId}

Получить существующий диалог

WebSocket

Платформа поддерживает WebSocket для получения обновлений в реальном времени о новых сообщениях и изменениях в диалогах.

ws://api.your-proff-manager.ru/ws

Формат Ответа

Все успешные ответы возвращаются в формате:

{
  "success": true,
  "data": { ... }
}

Ошибки возвращаются в формате:

{
  "success": false,
  "error": "Error message"
}

HTTP Коды Ответов

200Успешный запрос

201Ресурс создан

400Неверный запрос

401Требуется авторизация

404Ресурс не найден

500Внутренняя ошибка сервера

Готовы Начать Интеграцию?

Получите доступ к админ-панели и начните использовать API

Перейти в админ-панель