Документация

Добро пожаловать в Uskorix Cloud — единую платформу управления распределённой инфраструктурой для бизнеса. На этой странице описаны основные возможности платформы, API и партнёрская программа.

Обзор платформы

Uskorix Cloud построена на трёх ключевых примитивах:

Рабочие пространства — изоляция на уровне организации или бизнес-подразделения
Проекты — группировка сервисов, сред и ресурсов
Ресурсы — деплойменты, базы данных, хранилища объектов, очереди и edge-узлы

Все операции доступны через веб-консоль, REST API и CLI uskx.

Архитектура

Платформа работает как мульти-региональная mesh-сеть из stateless управляющих узлов с глобально-реплицированным хранилищем метаданных. Данные клиентов никогда не покидают регион создания без явного включения кросс-региональной репликации.

Компонент	Назначение
Control Plane	API, авторизация, журнал аудита
Data Plane	Воркеры в каждом регионе для клиентских нагрузок
Object Storage	S3-совместимое хранилище объектов (RustFS)
Metadata Store	Глобально-реплицированная конфигурация и состояние
Edge	Узлы кэширования в 28 PoP по всему миру

API

Все эндпоинты расположены по префиксу /api/v1/ и принимают JSON. Авторизация через Bearer-токены, выдаваемые при входе.

GET /api/v1/health
Accept: application/json
Authorization: Bearer usk_live_...

Основные эндпоинты

POST /api/v1/auth/login — обмен учётных данных на сессионный токен
POST /api/v1/auth/reset — запрос ссылки для сброса пароля
GET /api/v1/health — статус сервиса и компонентов
GET /api/v1/users/me — профиль текущего пользователя
GET /api/v1/storage/status — статус объектного хранилища (RustFS)

Хранилище объектов (Storage API)

Uskorix Cloud использует RustFS — высокопроизводительное S3-совместимое хранилище. Статус хранилища доступен через API:

GET /api/v1/storage/status

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

{
  "status": "active",
  "engine": "rustfs",
  "version": "0.2.4",
  "region": "eu-central-1",
  "buckets": 6,
  "total_objects": 14829,
  "used_bytes": 2147483648,
  "available_bytes": 53687091200,
  "uptime_seconds": 1284710,
  "replication": "single-region"
}

Управление бакетами

GET /api/v1/storage/buckets — список бакетов
POST /api/v1/storage/buckets — создать бакет
DELETE /api/v1/storage/buckets/{name} — удалить бакет
GET /api/v1/storage/buckets/{name}/objects — список объектов

Прямой S3-совместимый доступ доступен через /s3/ эндпоинт с подписью AWS Signature V4.

Токены API истекают через 30 минут бездействия. SDK автоматически обновляют их.

SDK

Официальные SDK доступны для Go, Python, TypeScript и Rust. Они автоматически обрабатывают повторные попытки, пагинацию и обновление токенов.

npm install @uskorix/sdk
pip install uskorix-cloud
go get github.com/uskorix/sdk-go
cargo add uskorix-sdk

CRM и управление клиентами

Uskorix Cloud включает встроенный модуль CRM для партнёров:

Управление аккаунтами — создание и настройка клиентских аккаунтов
Квоты и лимиты — гибкая система квот по ресурсам, хранилищу и трафику
Биллинг — автоматический расчёт стоимости с поминутной гранулярностью
Аналитика — панель с метриками использования по каждому клиенту
Уведомления — автоматические алерты при превышении квот или деградации сервиса

CRM API

GET  /api/v1/crm/accounts          — список клиентских аккаунтов
POST /api/v1/crm/accounts          — создать аккаунт
GET  /api/v1/crm/accounts/{id}     — детали аккаунта
PUT  /api/v1/crm/accounts/{id}     — обновить аккаунт
GET  /api/v1/crm/accounts/{id}/usage — статистика использования
GET  /api/v1/crm/billing/summary   — сводка по биллингу

Партнёрская программа

Uskorix Cloud предлагает партнёрскую программу для реселлеров и системных интеграторов.

Уровни партнёрства

Уровень	Скидка	Минимум клиентов	Техподдержка
Silver	15%	5	Email, 48ч SLA
Gold	25%	20	Чат + Email, 12ч SLA
Platinum	35%	50	Выделенный менеджер, 4ч SLA

Как стать партнёром

Подать заявку — заполните форму на /partners/apply или отправьте запрос на partners@uskorix.ru
Верификация — наша команда проверит вашу компанию (1-3 рабочих дня)
Активация — после одобрения вы получаете доступ к партнёрской панели и API-ключи для CRM
Интеграция — используйте CRM API для автоматизации управления клиентами

Партнёрские возможности

White-label консоль — кастомизация интерфейса под ваш бренд
API для автоматизации — полный доступ к CRM API для интеграции с вашими системами
Мультитенантность — управление множеством клиентов из единой панели
Реферальная программа — 10% от оплат привлечённых клиентов в первый год
Обучение и сертификация — бесплатный курс и сертификат для инженеров партнёра

Регионы

Доступные регионы для размещения ресурсов:

Регион	Код	Хранилище	Статус
Москва	`ru-central-1`	RustFS	Активен

FAQ

Где хранятся мои данные? В регионе ru-central-1 (Москва). Все данные хранятся на территории РФ в соответствии с требованиями 152-ФЗ.

Как рассчитывается стоимость? По активным ресурсам в час, с поминутной гранулярностью. Актуальное потребление видно в консоли.

Есть бесплатный тариф? Да — до 3 ресурсов, 1 рабочее пространство, 10 ГБ хранилища и 5 ГБ трафика в месяц.

Какой SLA? 99.95% для платных тарифов, 99.9% для бесплатного.

Как объектное хранилище связано с платформой? RustFS интегрирован как нативный компонент — все бакеты создаются и управляются через единый API.

Как связаться с поддержкой? Email support@uskorix.ru или чат в консоли (тарифы Gold и Platinum).

Как стать партнёром? Заполните заявку на /partners/apply или напишите на partners@uskorix.ru. Рассмотрение занимает 1-3 рабочих дня.