Discord作为目前主流的社区交流平台，很多站长和开发者希望将Discord服务器的相关数据同步展示到自己的网站中，比如服务器成员数、在线人数、频道列表等信息，方便访客快速了解社区活跃度。Discord官方提供了公开的REST API，支持开发者通过合法的凭证调用接口获取服务器相关数据，因此这个需求是完全可以实现的。
可行性分析
Discord API的设计初衷就是支持第三方应用接入，官方文档中明确提供了服务器相关的接口端点，只要满足以下条件就可以获取服务器数据：
- 拥有目标Discord服务器的管理权限，能够创建机器人并获取机器人令牌
- 机器人已经被添加到目标服务器中，且拥有对应接口的查看权限
- 如果是获取用户私有数据，还需要完成OAuth2授权流程
对于公开的服务器基础数据，比如服务器名称、成员数量、在线状态统计，不需要用户授权就可以直接通过机器人令牌调用接口获取，可行性非常高。
实践步骤
1. 申请Discord API凭证
首先需要到Discord开发者平台创建应用并添加机器人：
- 登录Discord开发者平台，点击新建应用，填写应用名称
- 在应用设置中找到机器人选项卡，点击添加机器人，开启服务器成员意图等必要权限
- 复制机器人的令牌，后续调用接口需要用到这个令牌作为身份凭证
- 使用OAuth2生成邀请链接，将机器人添加到目标服务器中
2. 调用API获取服务器数据
Discord API的服务器相关接口基础地址是https://discord.com/api/v10/，获取服务器基础信息的接口是/guilds/{guild_id}，其中{guild_id}是目标服务器的ID，可以在Discord客户端开启开发者模式后右键服务器复制ID。
以下是使用Node.js调用接口获取服务器数据的示例代码：
const https = require('https');
// 替换为你的机器人令牌和服务器ID
const botToken = '你的机器人令牌';
const guildId = '你的服务器ID';
const options = {
hostname: 'discord.com',
path: `/api/v10/guilds/${guildId}?with_counts=true`,
method: 'GET',
headers: {
'Authorization': `Bot ${botToken}`,
'Content-Type': 'application/json'
}
};
const req = https.request(options, (res) => {
let data = '';
res.on('data', (chunk) => {
data += chunk;
});
res.on('end', () => {
const guildData = JSON.parse(data);
console.log('服务器名称:', guildData.name);
console.log('总成员数:', guildData.approximate_member_count);
console.log('在线成员数:', guildData.approximate_presence_count);
});
});
req.on('error', (error) => {
console.error('请求出错:', error);
});
req.end();
注意请求路径中加上?with_counts=true参数，才能获取到成员数量的近似值，否则返回的数据中不会包含成员统计信息。
3. 前端渲染数据
获取到数据后，可以通过后端接口将数据返回给前端，前端使用HTML和JavaScript渲染到页面上。以下是一个简单的前端渲染示例：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Discord服务器数据展示</title>
<style>
.guild-card {
width: 300px;
padding: 20px;
border: 1px solid #ccc;
border-radius: 8px;
text-align: center;
}
.online {
color: #57f287;
}
</style>
</head>
<body>
<div class="guild-card" id="guildInfo">
<p>加载中...</p>
</div>
<script>
// 替换为你的后端接口地址
fetch('http://127.0.0.1:3000/api/guild-data')
.then(response => response.json())
.then(data => {
const guildInfo = document.getElementById('guildInfo');
guildInfo.innerHTML = `
<h3>${data.name}</h3>
<p>总成员数: ${data.memberCount}</p>
<p class="online">在线人数: ${data.onlineCount}</p>
`;
})
.catch(error => {
console.error('获取数据失败:', error);
});
</script>
</body>
</html>
注意事项
- 机器人令牌属于敏感信息，不要直接暴露在前端代码中，应该通过后端服务调用Discord API，再返回数据给前端
- Discord API有请求频率限制，普通机器人每秒最多发送50个请求，超出会被暂时封禁，调用时需要注意控制频率
- 如果需要获取服务器的私有频道信息或者用户私有数据，需要引导用户完成OAuth2授权流程，获取用户的访问令牌后再调用对应接口
- 服务器ID和机器人令牌不要泄露给无关人员，避免服务器数据被恶意调用或者机器人被滥用
Discord_API服务器数据展示Web开发OAuth2修改时间：2026-07-22 22:39:34