Консультации

API для работы с консультациями пользователей.

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

Возвращает список всех консультаций пользователя.

Endpoint: GET /api/v1/users/consultation/{id}

Параметры URL:

• id (integer, обязательный) - ID пользователя

Заголовки:

token: YOUR_PARTNER_API_KEY

Пример ответа:

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": 456,
        "status": "completed",
        "format": "chat",
        "client_user": "Иван Иванов",
        "price": 1500,
        "client_user_id": 123,
        "subject": "Консультация по питанию",
        "consultant_user_id": 789,
        "conversation_id": "conv_123",
        "is_error": 0,
        "created_at": 1638360000,
        "updated_at": 1638370000
      }
    ]
  }
}

Возможные ошибки:

• 404 - Пользователь не найден или не принадлежит партнеру

---

Просмотр сообщений консультации

Получение всех сообщений по конкретной консультации.

Endpoint: GET /api/v1/users/consultation-view/{id}

Параметры URL:

• id (integer, обязательный) - ID консультации

Заголовки:

token: YOUR_PARTNER_API_KEY

Пример ответа:

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": 1,
        "conversation_id": "conv_123",
        "user_id": 123,
        "type": "text",
        "data": "Здравствуйте, у меня вопрос по питанию кота",
        "file": null,
        "created_at": 1638360000
      },
      {
        "id": 2,
        "conversation_id": "conv_123",
        "user_id": 789,
        "type": "text",
        "data": "Здравствуйте! Расскажите подробнее о проблеме",
        "file": null,
        "created_at": 1638360100
      },
      {
        "id": 3,
        "conversation_id": "conv_123",
        "user_id": 123,
        "type": "file",
        "data": "Фото кота",
        "file": "https://kotzdorov.ru/files/photo.jpg",
        "created_at": 1638360200
      }
    ]
  }
}

Возможные ошибки:

• 404 - Консультация не найдена или не принадлежит партнеру

---

Получение заключения

Получение заключения врача по консультации.

Endpoint: GET /api/v1/users/consultation-conclusion/{id}

Параметры URL:

• id (integer, обязательный) - ID консультации

Заголовки:

token: YOUR_PARTNER_API_KEY

Пример ответа:

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": 10,
        "consultation_id": 456,
        "path": "https://kotzdorov.ru/conclusions/conclusion_456.pdf",
        "type": "conclusion",
        "created_at": 1638370000
      }
    ]
  }
}

Возможные ошибки:

• 404 - Консультация не найдена или заключение отсутствует

---

История звонков

Получение истории звонков пользователя.

Endpoint: GET /api/v1/users/call-history/{id}

Параметры URL:

• id (integer, обязательный) - ID пользователя

Заголовки:

token: YOUR_PARTNER_API_KEY

Пример ответа:

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": 100,
        "user_id": 123,
        "partner_id": 5,
        "operator_user_id": 50,
        "call_id": "call_abc123",
        "direction": "inbound",
        "caller": "79001234567",
        "duration": 320,
        "record": 1,
        "record_url": "https://kotzdorov.ru/records/call_abc123.mp3",
        "caller_provider": "voximplant",
        "status": "completed",
        "created_at": 1638360000
      }
    ]
  }
}

Возможные ошибки:

• 404 - Пользователь не найден или не принадлежит партнеру

---

Структура данных

Объект Consultation

Поле	Тип	Описание
id	integer	ID консультации
status	string	Статус (pending/active/completed/cancelled)
format	string|null	Формат (chat/video/call)
client_user	string|null	Имя клиента
price	integer	Стоимость консультации
client_user_id	integer	ID клиента
subject	string|null	Тема консультации
consultant_user_id	integer	ID консультанта
conversation_id	string|null	ID беседы
is_error	integer|null	Флаг ошибки (0/1)
created_at	integer	Unix timestamp создания
updated_at	integer	Unix timestamp обновления

Объект Message

Поле	Тип	Описание
id	integer	ID сообщения
conversation_id	string|null	ID беседы
user_id	integer	ID отправителя
type	string	Тип (text/file/image/video)
data	string|null	Текст сообщения или описание файла
file	string|null	URL файла
created_at	integer	Unix timestamp создания

Объект CallHistory

Поле	Тип	Описание
id	integer	ID записи
user_id	integer	ID пользователя
partner_id	integer|null	ID партнера
operator_user_id	integer|null	ID оператора
call_id	string	Уникальный ID звонка
direction	string	Направление (inbound/outbound)
caller	string	Номер звонящего
duration	integer	Длительность в секундах
record	integer	Наличие записи (0/1)
record_url	string|null	URL записи звонка
caller_provider	string	Провайдер связи
status	string	Статус звонка
created_at	integer	Unix timestamp создания