Перейти к содержанию

Конфигурация донатных интеграций

DonateX OAuth

Официальное подключение DonateX использует Authorization Code + PKCE S256 и работает в ownadmin-api. Callback для регистрации приложения: https://pulsecaster.ru/api/v1/donation-platforms/donate-x/oauth/callback.

В .env production compose задаются:

PULSECASTER_DONATEX_OAUTH_ENABLED=true
PULSECASTER_DONATEX_OAUTH_CLIENT_ID=
PULSECASTER_DONATEX_OAUTH_CLIENT_SECRET=
PULSECASTER_DONATEX_OAUTH_REDIRECT_URL=https://pulsecaster.ru/api/v1/donation-platforms/donate-x/oauth/callback

Заполните пустые значения выданными площадкой ключами в untracked .env (права 0600). Не включайте OAuth до заполнения ключей. Compose передаёт их только ownadmin-api как PCB_DONATE_X_OAUTH__*. При прямом запуске сервиса используются PCB_DONATE_X_OAUTH__ENABLED, __CLIENT_ID, __CLIENT_SECRET, __REDIRECT_URL. Поле конфигурации — donate_x_oauth; endpoints по умолчанию: https://donatex.gg/api/connect/authorize и https://donatex.gg/api/connect/token.

Минимальные scopes: user.read donations.read donations.subscribe offline_access. Права изменения донатов, алертов и музыки не запрашиваются. Access token и ротируемый refresh token сохраняются зашифрованными на сервере. PKCE verifier также зашифрован, привязан к сессии и очищается при её завершении. Старые подключения по API-ключу продолжают работать; переход на OAuth выполняет владелец явно.