# Wow vtorichka API Documentation

## Overview
Платформа-агрегатор проверенной вторичной недвижимости с системой платных отчетов о юридической чистоте.

## Services

### Auth Service (Port 8001)
- POST /auth/register - Регистрация пользователя
- POST /auth/login - Авторизация
- GET /auth/profile - Получение профиля
- PUT /auth/update-profile - Обновление профиля
- GET /auth/users - Список пользователей (admin)
- PUT /auth/users/{id}/roles - Обновление ролей (admin)
- POST /auth/users/{id}/block - Блокировка пользователя (moderator)
- POST /auth/users/{id}/unblock - Разблокировка пользователя (moderator)

### Property Service (Port 8002)
- GET /properties/search - Поиск объектов
- GET /properties/{id} - Получение объекта
- POST /properties - Создание объекта
- PUT /properties/{id} - Обновление объекта
- DELETE /properties/{id} - Удаление объекта
- GET /properties/my - Мои объекты
- POST /properties/{id}/favorite - Добавить в избранное
- GET /properties/favorites - Избранные объекты
- GET /properties/pending - Объекты на модерации (moderator)
- POST /properties/{id}/approve - Одобрить объект (moderator)
- POST /properties/{id}/reject - Отклонить объект (moderator)

### Report Service (Port 8004)
- GET /reports/{id} - Получение отчета
- POST /reports - Создание отчета (moderator)
- GET /reports/pending - Отчеты в работе (moderator)
- GET /reports/{id}/items - Элементы отчета (moderator)
- PUT /reports/{id}/items/{item_id} - Обновление элемента (moderator)
- POST /reports/{id}/complete - Завершение отчета (moderator)
- GET /reports/my - Мои отчеты
- POST /reports/{id}/purchase - Покупка отчета

### Payment Service (Port 8005)
- POST /payments/create - Создание платежа
- GET /payments/{id}/status - Статус платежа
- GET /payments/my - Мои платежи
- GET /payments/stats - Статистика платежей (admin)
- POST /payments/webhook - Webhook от ЮMoney

### Support Service (Port 8007)
- POST /support/webhook/telegram - Webhook от Telegram бота
- GET /support/tickets - Список обращений (moderator)
- GET /support/tickets/{id} - Получение обращения (moderator)
- POST /support/tickets/{id}/respond - Ответ на обращение (moderator)
- PUT /support/tickets/{id}/status - Обновление статуса (moderator)
- GET /support/support-types - Типы обращений

## Authentication
Все защищенные маршруты требуют заголовок Authorization с JWT токеном:
```
Authorization: Bearer <jwt_token>
```

## Roles
- **user**: Обычный пользователь
- **moderator**: Модератор
- **admin**: Администратор

## Response Format
Все ответы в формате JSON:
```json
{
  "data": {},
  "message": "Success",
  "status": "ok"
}
```

## Error Format
```json
{
  "error": "Error message",
  "status": "error"
}
```