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

Roxera Premium — подписка на проекты Roxera. В основе лежит Roxera ID: один аккаунт, один пароль, одна сессия на .roxera.net. Проекты проверяют вход через OIDC или общую cookie и получают актуальный статус Premium.

Все примеры ниже рабочие. Базовый URL API — https://oauth.roxera.net, для first-party проектов можно использовать относительные пути с той же cookie.

SSO и OIDC

Authorization Code + PKCE, ID token, JWKS, popup-виджет и общая сессия для поддоменов.

EdDSAPKCE S256

Premium API

Проверка подписки, entitlements по проектам, OAuth userinfo и кэширование результата.

$5 / 30 дней8 проектов

Почта и temp-mail

IMAP/SMTP для внешних клиентов, лимиты, catch-all, временные адреса и публичные вложения.

IMAP · SMTPTemp-mail

Личный кабинет

Статус подписки, оплата Stars и CryptoBot, привязка Telegram и история платежей.

StarsUSDT

Telegram-бот

Статус Premium, оплата Stars и CryptoBot, уведомления о платежах и почте — прямо в чате.

@roxerapremiumbotУведомления

Быстрый старт для нового проекта

  1. Создайте OAuth-клиент в админке: redirect URI, scopes, тип клиента.
  2. Добавьте вход через OIDC или popup-виджет https://oauth.roxera.net/widget.js.
  3. Проверьте Premium по claim premium в ID token или через /oauth/userinfo.
  4. Ограничьте функции проекта по entitlements.<projectKey> из ответа.

Базовые адреса

ЧтоАдрес
OIDC issuerhttps://oauth.roxera.net
Discovery/.well-known/openid-configuration
APIhttps://oauth.roxera.net/api/v1
Почтовый веб-клиентhttps://mail.roxera.net
Админкаhttps://mail.roxera.net/admin/
Premium-лендингhttps://premium.roxera.net

Принципы

Начать с SSO