REST · v1 · JSON

Platform 365 API

Документация и песочница: список методов и тест запросов.

Быстрый старт

Хостинг (nginx): Base URL = https://apart365.sonsuz.kg/api/v1/index.php (пути как ?route=auth/login).
Публичные API — без токена: страны, города, каталог недвижимости, услуги.
Тестовый вход: POST /auth/login — demo@example.com / password (после seed SQL на хостинге)
Регистрация: только POST + JSON в Body (не вкладка Параметры). Открытие URL в браузере = GET → «Method not allowed».
Скопируйте token из ответа → поле ниже → «Сохранить».
Клик по endpoint открывает песочницу с примером тела запроса.
Доп. UI: api-sandbox.html · карта всех страниц прототипа
Избранное (нужен токен): GET /favorites, POST /favorites/toggle, POST /favorites/check
Голос: POST /voice/chat — при необходимости ключи AI в .env

📷 Фотографии объектов (квартиры, отели, апартаменты)

Один API для всех типов жилья (property_type_id). Сначала JSON — создать объект, затем multipart — загрузить фото.

POST /auth/login → токен owner
POST /owner/properties → JSON, получить id
POST /owner/properties/{id}/images → поле images[] (файлы), не JSON
GET /properties/{slug} → массив images для галереи

URL картинки в приложении:

—

mediaUrl(path) = SITE_ORIGIN + "/" + path — origin без /api/v1

Действие	Метод	Auth	Body
Загрузить фото	`POST /owner/properties/{id}/images`	Bearer	`multipart`, поля `images[]` или `image`
Удалить фото	`DELETE /owner/properties/{id}/images/{imageId}`	Bearer	—
Галерея (каталог)	`GET /properties/{slug}`	—	до 10 фото в `images[]`
Галерея (owner)	`GET /owner/properties/{id}`	Bearer	`images[]` с `id`, `is_primary`

Форматы: jpg, jpeg, png, gif, webp. На сервере: папка uploads/properties/, права на запись PHP. Полная инструкция: redmi.txt раздел 5.

Base URL:

🔐 Авторизация

Категорий

Endpoints

Публичных

Защищённых

GET Получение

POST Создание

PUT Обновление

DELETE Удаление

Public Без авторизации

Auth Требуется токен

API 1 endpoints

GET / Public

Проверка работы API (приветствие)

Аутентификация 6 endpoints

POST /auth/register Public

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

POST /auth/login Public

Вход в систему

POST /auth/forgot-password Public

Восстановление пароля

POST /auth/logout Auth

Выход из системы

POST /auth/refresh Auth

Обновление токена

GET /auth/me Auth

Получить текущего пользователя

География 9 endpoints

GET /countries Public

Список стран

GET /countries/{id} Public

Информация о стране

GET /countries/{id}/regions Public

Регионы страны

GET /countries/{id}/cities Public

Города страны

GET /regions Public

Список регионов

GET /regions/{id} Public

Информация о регионе

GET /cities Public

Список городов

GET /cities/popular Public

Популярные города

GET /cities/{id} Public

Информация о городе

Справочники 9 endpoints

GET /currencies Public

Список валют

GET /currencies/default Public

Валюта по умолчанию

GET /currencies/{code} Public

Информация о валюте

GET /property-types Public

Типы недвижимости

GET /amenities Public

Список удобств

GET /amenities/categories Public

Категории удобств

GET /service-categories Public

Категории услуг

GET /service-categories/tree Public

Дерево категорий

GET /cancellation-policies Public

Политики отмены

Недвижимость 6 endpoints

GET /properties Public

Список недвижимости

GET /properties/{slug} Public

Информация об объекте

GET /properties/{slug}/availability Public

Доступность

GET /properties/{slug}/reviews Public

Отзывы

POST /properties/{slug}/calculate-price Public

Расчет цены

GET /properties/{id}/360-images Public

360° фото объекта

Бронирования 4 endpoints

GET /bookings Auth

Мои бронирования

GET /bookings/{bookingNumber} Auth

Информация о бронировании

POST /bookings Auth

Создать бронирование

POST /bookings/{bookingNumber}/cancel Auth

Отменить бронирование

Владелец (owner) 13 endpoints

GET /owner/dashboard Auth

Дашборд владельца

GET /owner/properties Auth

Мои объекты

POST /owner/properties Auth

Создать объявление (жильё)

GET /owner/properties/{id} Auth

Объект владельца

PUT /owner/properties/{id} Auth

Обновить объект

DELETE /owner/properties/{id} Auth

Удалить объект

POST /owner/properties/{id}/images Auth

Загрузить фото (multipart: images[])

DELETE /owner/properties/{id}/images/{imageId} Auth

Удалить фото объекта

GET /owner/bookings Auth

Брони моих объектов

GET /owner/services Auth

Мои услуги

POST /owner/services Auth

Создать услугу

PUT /owner/services/{id} Auth

Обновить услугу

DELETE /owner/services/{id} Auth

Удалить услугу

Услуги 4 endpoints

GET /services Public

Список услуг

GET /services/{slug} Public

Информация об услуге

GET /service-providers Public

Провайдеры услуг

GET /service-providers/{slug} Public

Информация о провайдере

Инвестиции 6 endpoints

GET /investments Public

Список инвестиционных объектов

GET /investments/{uuid} Public

Информация об объекте

GET /investments/marketplace Public

Вторичный рынок

GET /investments/portfolio Auth

Мой портфель

GET /investments/my-shares Auth

Мои доли

POST /investments/{uuid}/purchase Auth

Купить доли

Отзывы 4 endpoints

GET /reviews Public

Список отзывов

GET /reviews/{uuid} Public

Информация об отзыве

POST /reviews Auth

Создать отзыв

POST /reviews/{uuid}/vote Auth

Голосовать за отзыв

Избранное 3 endpoints

GET /favorites Auth

Список избранного

POST /favorites/toggle Auth

Добавить/удалить из избранного

POST /favorites/check Auth

Проверить в избранном

Сообщения 5 endpoints

GET /conversations Auth

Список чатов

GET /conversations/unread-count Auth

Количество непрочитанных

POST /conversations Auth

Начать чат

GET /conversations/{uuid}/messages Auth

Сообщения чата

POST /conversations/{uuid}/messages Auth

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

Уведомления 4 endpoints

GET /notifications Auth

Список уведомлений

GET /notifications/unread-count Auth

Количество непрочитанных

POST /notifications/mark-all-read Auth

Прочитать все

POST /notifications/{uuid}/read Auth

Прочитать

Поиск 3 endpoints

GET /search/properties Public

Поиск недвижимости

GET /search/services Public

Поиск услуг

GET /search/global Public

Глобальный поиск

Платежи 4 endpoints

GET /payments Auth

Мои платежи

GET /payments/{transactionId} Auth

Информация о платеже

GET /payment-methods Auth

Методы оплаты

POST /payment-methods Auth

Добавить метод оплаты

Промокоды 1 endpoints

POST /promo-codes/validate Auth

Проверить промокод

Голосовой помощник (GPT/Gemini) 5 endpoints

POST /voice/session Public

Создать сессию помощника

GET /voice/session/{token} Public

Информация о сессии

POST /voice/session/{token}/end Public

Завершить сессию

POST /voice/chat Public

Отправить сообщение (GPT/Gemini)

POST /voice/session/{token}/chat Public

Сообщение в сессии

Platform 365 API

Быстрый старт

📷 Фотографии объектов (квартиры, отели, апартаменты)

🔐 Авторизация

API Sandbox

Ответ