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

Базовый 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