Noxyr 现在提供免费的、按服务器划分的 REST API，让你可以把实时 Discord 数据（成员数、工单分析、活跃指标、销售、评价和抽奖）拉取到你的网站、控制面板、移动应用或其他机器人中。 每个服务器一把密钥，在控制面板中生成，采用 SHA-256 哈希加密保护，并由你自己控制的范围开关来限制访问。
为什么采用按服务器划分范围的 API？
大多数 Discord 机器人要么不提供任何数据，要么需要你自己处理原始 Discord API，还要应付 intents、网关连接和速率限制的计算。Noxyr 服务器 API 恰恰相反：发送一个请求头，就能得到 JSON。六个接口覆盖了服务器管理员最常问的问题：有多少成员、本周有多少工单、各货币的收入、平均评价分数、正在进行的抽奖，以及每日活跃趋势。
目前可以读取的数据
GET /api/v1/server：服务器名称、图标 URL、实时成员数、在线人数、助力数、创建日期。GET /api/v1/tickets：工单总数 / 未关闭 / 已关闭，过去 7 天和 30 天新开的工单，过去 7 天关闭的工单，平均评分和评分数量。GET /api/v1/activity?days=30：最多 90 天的每日消息数、加入和离开人数，缺失的日期会补零，确保每一天都有数据。GET /api/v1/invoices：发票数量、7 天 / 30 天的交易量，以及各货币的收入，外加付款状态分布。GET /api/v1/reviews：已发布评价总数、平均评分、1–5 星分布，以及最新 5 条评价（商品、评分、简短内容、作者）。GET /api/v1/giveaways：进行中 / 已结束的数量、参与总人次，以及即将结束的 5 个进行中抽奖。
安全模型
密钥以 nxr_ 开头，具有 192 位熵。服务器上只存储 SHA-256 哈希值，原始密钥仅在生成时显示一次，之后无法找回。每个响应都要经过两项检查：密钥是否已启用，以及该接口的范围是否已开启。关闭某个范围会立即返回 403；禁用或撤销密钥会立即终止所有访问，无需重新部署。速率限制按密钥计算，每分钟 60 次请求。
快速上手（60 秒）
- 1. 打开控制面板，选择你的服务器，进入 API 访问。
- 2. 点击 生成 API 密钥并复制该值；这是它唯一一次显示。
- 3. 开启或关闭各项范围。每个范围都有各自的开关。
- 4. 调用
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"，即可开始使用。
常见集成场景
在你的落地页上显示实时成员计数器。每周在私密的员工频道中发布工单摘要。制作一个公开的抽奖参与排行榜。把销售数据接入电子表格或你自己的管理面板。由于响应都是普通 JSON，并且 CORS 策略宽松，你可以直接在浏览器中调用 API，无需任何代理。
接下来可以看什么
相关阅读：Discord API 与 Noxyr 服务器 API 的对比、分步教程、这些接口背后的设计原则，以及我们如何处理 Discord API 错误。