Общая информация

Базовый URL: https://servt.4dev.app/api/hs/restapi_v1

Авторизация: JWT Token в заголовке Authorization.

Формат заголовка: Authorization: <token> (без префикса Bearer, судя по примерам).

Content-Type: application/json (для большинства запросов).

🔐 1. Auth (Авторизация)

Методы для входа в систему, получения и обновления токенов.

1.1 Запрос OTP кода

Отправляет одноразовый пароль на указанный номер телефона.

  • URL: /auth/otp/request

  • Метод: POST

  • Заголовки:

    • Origin: 4dev.app

    • Authorization: Токен приложения (API Key)

  • Тело запроса (JSON):

    json
    { "phone": "+79999999912", "channel": "email" }

1.2 Идентификация сервиса

  • URL: /auth/identity

  • Метод: POST

  • Тело запроса (JSON):

    json
    { "service": "lkagent" }

1.3 Верификация OTP

Проверка введенного кода и получение токенов.

  • URL: /auth/otp/verify

  • Метод: POST

  • Тело запроса (JSON):

    json
    { "phone": "+79999999912", "otp": "82629" }

1.4 Обновление токена (Refresh)

  • URL: /auth/refresh

  • Метод: GET

  • Заголовки:

    • Authorization: Текущий Access Token

1.5 Получение прав (Permissions)

  • URL: /agent/permissions

  • Метод: GET

  • Параметры:

    • agent (query): ID агента (опционально, если пусто - берется из токена).

  • Заголовки:

    • Authorization: Access Token

📅 2. Calendar (Календарь и Встречи)

Управление расписанием и встречами с менеджерами.

2.1 Получение слотов (Slots)

Получает список доступных временных интервалов для записи.

  • URL: /meetings/slots

  • Метод: GET

  • Заголовки: Authorization

2.2 Создание встречи (Create)

  • URL: /meetings/create

  • Метод: POST

  • Заголовки: Authorization

  • Тело запроса (JSON):

    json
    { "start_time": "2025-12-08T10:00:00", "end_time": "2025-12-08T11:00:00", "manager_id": "f798b7b2-5474-11ef-a293-00155dfb1a1c", "user_id": "346eea5c-c541-11f0-9de6-1c98ec2a636e", "client_id": "85dc768d-c5fb-11f0-9de6-1c98ec2a636e", "comment": "Test" }

2.3 Отмена встречи (Cancel)

  • URL: /meetings/cancel

  • Метод: POST

  • Заголовки: Authorization

  • Тело запроса (JSON):

    json
    { "meetingId": "47cb48da-e1b2-11f0-9df7-1c98ec2a636e" }

👥 3. Clients (Клиенты)

Работа с клиентской базой.

3.1 Список клиентов

  • URL: /agent/clients/list

  • Метод: GET

  • Параметры:

    • user_id (query): ID агента (UUID).

  • Заголовки: Authorization

3.2 История сделок клиента (Deals List)

Используется для получения истории покупок конкретного клиента (или всех клиентов агента).

  • URL: /agent/deals/list

  • Метод: GET

  • Заголовки: Authorization

  • Примечание: Возвращает массив объектов с деталями (сделка, клиент, объект, агент, менеджер).

3.3 Закрепление клиента (Fixation Create)

  • URL: /agent/fixation/create

  • Метод: POST

  • Заголовки: Authorization, Content-Type: application/json

  • Тело запроса (JSON):

    json
    { "phone": "+79222684823", "full_name": "Иванов Иван", "user_id": "346eea5c-c541-11f0-9de6-1c98ec2a636e", "mode": "auto" }

    • mode: Режим фиксации (например, auto или review).

💰 4. Rewards (Вознаграждения)

Финансовая информация агента.

4.1 Список вознаграждений

  • URL: /agent/rewards

  • Метод: GET

  • Параметры:

    • user_id (query): ID агента.

  • Заголовки: Authorization

4.2 Сводка (Summary)

Общая информация о заработке.

  • URL: /agent/rewards/summary

  • Метод: GET

  • Параметры:

    • user_id (query): ID агента.

  • Заголовки: Authorization

🏢 5. Objects (Объекты и Бронирование)

5.1 Создание бронирования (Booking Create)

  • URL: /bookings/create

  • Метод: POST

  • Заголовки: Authorization

  • Тело запроса (JSON):

    json
    { "mode": "free", "unit_id": "3daa7d75-7e16-11ee-bafe-ac162dab9b47", "client_id": "bee43e4d-c6d3-11f0-9de6-1c98ec2a636e", "agent_id": "346eea5c-c541-11f0-9de6-1c98ec2a636e", "passport_data": { "document_type": "Паспорт РФ", "series": "1234", "number": "567890", "issued_by": "ОВД...", "birth_date": "2000-11-19T12:23:32Z", "issue_date": "2020-11-19T12:23:32Z", "birth_place": "г. Екатеринбург", "registration_address": "...", "issued_code": "772-600" } }

👤 6. Agent (Кабинет Агента - Общее)

6.1 Список агентств

  • URL: /agent/agencies

  • Метод: GET

  • Заголовки: Authorization

6.2 Запрос на регистрацию агента

Отправка заявки менеджеру на добавление нового агента.

  • URL: /agent/registration_request

  • Метод: POST

  • Заголовки: Authorization

  • Тело запроса (JSON):

    json
    { "full_name": "Иванов Иван Иванович", "phone": "+7993235451", "email": "test@mail.ru", "user_id": "346eea5c-c541-11f0-9de6-1c98ec2a636e" }

6.3 Добавление агента (руководителем)

  • URL: /agent/add_agent

  • Метод: POST

  • Заголовки: Authorization

6.4 Маркетинговые события

Получение списка акций и новостей. 

  • URL: //agent/marketing_events 

  • Метод: GET

  • Заголовки: Authorization

6.5 Список офисов

  • URL: /offices

  • Метод: GET

  • Заголовки: Authorization