REST · v1 · JSON

Platform 365 API

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

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

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

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

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

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

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

—

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

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

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

Base URL:

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

17
Категорий
87
Endpoints
45
Публичных
42
Защищённых
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 — Документация и песочница в одном месте

87 endpoints | Просмотр и тестирование | v1.0 | 2026-06-06 05:23:50