Інтеграція Discord API з сайтом (сповіщення, боти)

Інтеграція Discord API з веб-сайтом (сповіщення, боти)

Discord — популярна платформа для ігрових та технічних спільнот. Інтеграція з сайтом дозволяє: сповіщати спільноту про новий матеріал, перевіряти власність NFT або ліцензій, створювати закриті канали для платних підписників.

Discord Webhooks (сповіщення)

class DiscordNotifier
{
    public function send(string $webhookUrl, array $embeds): void
    {
        Http::post($webhookUrl, [
            'embeds' => $embeds,
        ]);
    }

    public function announceNewArticle(Article $article): void
    {
        $this->send(config('services.discord.news_webhook'), [[
            'title'       => $article->title,
            'description' => $article->excerpt,
            'url'         => route('articles.show', $article->slug),
            'color'       => 0x5865F2,   // Discord Blurple
            'image'       => ['url' => $article->cover_url],
            'timestamp'   => $article->published_at->toIso8601String(),
            'footer'      => ['text' => 'example.com'],
        ]]);
    }
}

OAuth2: авторизація через Discord

Для доступу до закритих розділів сайту — авторизація через Discord-акаунт:

Route::get('/auth/discord/redirect', function () {
    return redirect(
        'https://discord.com/api/oauth2/authorize?' .
        http_build_query([
            'client_id'     => config('services.discord.client_id'),
            'redirect_uri'  => route('auth.discord.callback'),
            'response_type' => 'code',
            'scope'         => 'identify guilds.members.read',
        ])
    );
});

Route::get('/auth/discord/callback', function (Request $request) {
    // Обмін коду на токен
    $tokenResp = Http::post('https://discord.com/api/oauth2/token', [
        'client_id'     => config('services.discord.client_id'),
        'client_secret' => config('services.discord.client_secret'),
        'code'          => $request->code,
        'grant_type'    => 'authorization_code',
        'redirect_uri'  => route('auth.discord.callback'),
    ])->json();

    // Отримання даних користувача
    $user = Http::withToken($tokenResp['access_token'])
        ->get('https://discord.com/api/users/@me')
        ->json();

    // Перевірка членства на сервері
    $member = Http::withToken($tokenResp['access_token'])
        ->get("https://discord.com/api/users/@me/guilds/{$guildId}/member")
        ->json();

    return redirect('/dashboard');
});

Role Gating: доступ за роллю на Discord-сервері

class DiscordRoleGate
{
    public function hasAccess(string $userId, string $accessToken): bool
    {
        $member = Http::withToken($accessToken)
            ->get("https://discord.com/api/users/@me/guilds/{$this->guildId}/member")
            ->json();

        $requiredRoles = config('services.discord.premium_role_ids');
        return !empty(array_intersect($member['roles'] ?? [], $requiredRoles));
    }
}

Графік

Сповіщення через Webhooks: 1 день. OAuth2 + role-gating: 3–4 дні.