Для разработчиков и интеграторов

Документация API и админ-панели

Техническое описание эндпоинтов, ролей, авторизации и веб-интерфейса для модераторов. Используйте эту страницу при подключении мобильного приложения или настройке backend.

Сервис доступен Base URL: https://www.identity.xsdk.ru/api/v1
// Мобильное приложение — вход пользователя
POST https://www.identity.xsdk.ru/api/v1/user/login
Content-Type: application/json

{
  "login": "user@example.com",
  "password": "secret123"
}

// Ответ
{
  "accessToken": "…",
  "tokenType": "Bearer",
  "role": 10,
  "roleLabel": "Пользователь"
}

Архитектура проекта

Три части на одном домене: лендинг, REST API и панель администратора.

⚡

REST API

Slim + MySQL. JSON-эндпоинты для регистрации, логина, профилей и управления пользователями.

🛡

Роли и доступ

Guest, User, Moderator, Admin. Bearer-токены и middleware для защищённых маршрутов.

📱

Для мобильного app

Клиент сохраняет accessToken и передаёт Authorization: Bearer … в каждом запросе.

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

За несколько шагов можно поднять backend локально или на хостинге.

1

Клонировать

Репозиторий с GitHub на сервер или локально.

git clone … && composer install
2

Настроить БД

Создать config/db.local.php и выполнить SQL из sql/.

curl https://www.identity.xsdk.ru/api/v1/db-check
3

Запустить

Document root → public_html. Лендинг, API и админка на одном домене.

php -S localhost:8080 -t public_html
4

Подключить app

В мобильном клиенте укажите base URL API и используйте login/registration.

https://www.identity.xsdk.ru/api/v1

API для мобильного приложения

Основные эндпоинты. Полная документация — в docs/API_DOCUMENTATION.md репозитория.

Публичные

POST
/api/v1/user/registration
Регистрация нового пользователя
POST
/api/v1/user/login
Вход, выдача accessToken
GET
/api/v1/db-check
Проверка подключения к БД

С Bearer-токеном

GET
/api/v1/me
Проверка авторизации
GET
/api/v1/me/profile
Свой профиль
PUT
/api/v1/me/profile
Обновить имя, телефон, аватар
GET
/api/v1/user/list
Список пользователей (Moderator+)
DEL
/api/v1/user/{id}
Удаление пользователя (Admin)

Интеграция в мобильный клиент

После login сохраняйте токен и добавляйте заголовок Authorization: Bearer <token> ко всем защищённым запросам.

Проверить API

Панель администратора

Веб-интерфейс на AdminLTE для модераторов и администраторов. Работает через тот же REST API.

🔐

Вход

/admin/login — авторизация через API, токен хранится в PHP-сессии.

👥

Пользователи

/admin/users — список, роли, удаление (для Admin).

📊

Дашборд

/admin — сводка и быстрые ссылки после входа.