常见问题
Uppercut GG 上服务器验证、Webhook 和投票奖励的工作原理
服务器验证
服务器可以分配给一个或多个账户。验证可证明列为所有者的人控制着该服务器的网站。
验证将列出的账户与服务器关联,并确认您控制着其网站。已验证的服务器会在其公开页面上显示已验证徽章。
验证文件
将一个 JSON 文件放置在您网站 URL 中其路径所指示的目录里。对于像 https://example.com/wiki 这样的网站 URL,请将文件托管在 https://example.com/wiki/uppercutgg-….json。您的确切 URL 会显示在您服务器的编辑页面和公开页面上。
uppercutgg-{fingerprint}.json
文件名基于您的网站 URL(主机名和路径)。您预期的文件名和完整托管 URL 会显示在您服务器的编辑页面和公开详情页面上。
JSON 格式
该文件必须是有效的 JSON,包含一个 server 对象,其中含有一个列出账户 ID(最多 10 个)的 owner_account_ids 数组:
{
"server": {
"owner_account_ids": [42, 99, 123]
}
}
每个 ID 都必须与现有账户匹配。可在您的仪表板或账户设置页面找到您的账户 ID。
自动检查
Uppercut GG 每天检查验证文件。在您托管文件后,验证最长可能需要 24 小时。如果您更改了网站 URL,预期的文件名也会随之改变。
Webhook
Webhook 让您的服务器能够在 Uppercut GG 上发生事件时(例如有人为您的服务器投票时)接收 HTTP 通知。
在您的仪表板中,通过“我的服务器 → 每个服务器的 Webhook”来配置 Webhook。您需要提供 URL、事件类型和密钥;事件将以 HTTP POST 请求的形式投递。
Webhook 必须启用才能接收事件。已禁用的 Webhook 在重新启用前会被忽略。
每个请求都使用您的 Webhook 密钥通过 HMAC 签名。在处理负载之前,请在您的端点上验证签名。
当服务器拥有一个已启用并订阅了服务器投票事件(server_vote.created)的 Webhook 时,它会在公开列表中显示为“已集成”。
投票奖励
当您登录并为服务器投票时,您会因该投票获得积分。匿名投票仍会计入服务器,但不会获得积分。
通过投票获得的积分每个账户每天限 1,000 分。一旦达到每日上限,额外的投票仍会计入服务器,但在次日(UTC)之前不会再获得更多积分。
花费积分
您赚取的积分可用于推广您管理的公会或服务器。
为公会置顶需要花费100积分,并将其移至公会目录顶部。每个公会每12小时只能置顶一次。
发布公告需要花费150积分。草稿是免费的,且每篇公告只会被收费一次——取消发布后重新发布不会再次收费。
服务器公告的运作方式相同,同样需要150积分,但有一点不同:只有通过验证的服务器才能发布。撰写草稿是免费的,随时可用。 服务器验证的运作方式
使用表情符号回应一篇公告,首次使用该表情符号需花费25积分。之后您可以免费开关该回应。
积分不予退还。删除公告或归档公会不会退还为其花费的积分。