Вопросы и ответы
Как работают подтверждение серверов, вебхуки и награды за голосование на Uppercut GG
Подтверждение сервера
Серверы можно привязать к одному или нескольким аккаунтам. Подтверждение доказывает, что люди, указанные как владельцы, контролируют сайт сервера.
Подтверждение связывает указанные аккаунты с сервером и подтверждает, что вы контролируете его сайт. Подтверждённые серверы показывают значок подтверждения на публичной странице.
Файл подтверждения
Разместите JSON-файл по URL вашего сайта, в каталоге, указанном его путём. Для URL сайта вида https://example.com/wiki разместите файл по адресу https://example.com/wiki/uppercutgg-….json. Ваш точный URL показан на страницах редактирования и публичной страницы вашего сервера.
uppercutgg-{fingerprint}.json
Имя файла основано на URL вашего сайта (имя хоста и путь). Ожидаемое имя файла и полный URL для размещения показаны на странице редактирования сервера и публичной странице сведений.
Формат JSON
Файл должен быть корректным JSON с объектом server, содержащим массив owner_account_ids, перечисляющим ID аккаунтов (до 10):
{
"server": {
"owner_account_ids": [42, 99, 123]
}
}
Каждый ID должен соответствовать существующему аккаунту. Найдите ID своего аккаунта на панели управления или на странице настроек аккаунта.
Автоматические проверки
Uppercut GG проверяет файлы подтверждения ежедневно. После размещения файла подтверждение может занять до 24 часов. Если вы измените URL сайта, ожидаемое имя файла тоже изменится.
Вебхуки
Вебхуки позволяют вашему серверу получать HTTP-уведомления, когда на Uppercut GG происходят события, например когда кто-то голосует за ваш сервер.
Настройте вебхуки на панели управления в разделе «Мои серверы → Вебхуки» для каждого сервера. Вы указываете URL, типы событий и секрет; события доставляются как HTTP-запросы POST.
Чтобы получать события, вебхук должен быть включён. Отключённые вебхуки игнорируются до повторного включения.
Каждый запрос подписывается HMAC с помощью вашего секрета вебхука. Проверяйте подпись на своём эндпоинте перед обработкой полезной нагрузки.
Сервер отображается как «Интегрирован» в публичном списке, когда у него есть включённый вебхук, подписанный на события голосов за сервер (server_vote.created).
Награды за голосование
Когда вы вошли в систему и голосуете за сервер, вы получаете очки за голос. Анонимные голоса всё равно засчитываются серверу, но не приносят очков.
Очки за голоса ограничены 1 000 в день на аккаунт. После достижения дневного лимита дополнительные голоса всё ещё засчитываются серверу, но не приносят больше очков до следующего дня (UTC).
Трата очков
Заработанные очки можно потратить на продвижение гильдии или сервера, которыми вы управляете.
Поднятие гильдии стоит 100 очков и перемещает её в начало каталога гильдий. Гильдию можно поднимать раз в 12 часов.
Публикация записи стоит 150 очков. Черновики бесплатны, и с каждой записи списывается плата только один раз — снятие с публикации и повторная публикация ничего не стоят.
Записи сервера работают так же и тоже стоят 150 очков, с одним отличием: публиковать их может только подтверждённый сервер. Черновики бесплатны и доступны всегда. Как работает подтверждение сервера
Реакция на запись с помощью эмодзи стоит 25 очков при первом использовании этого эмодзи на ней. После этого вы можете включать и выключать реакцию бесплатно.
Очки не возвращаются. Удаление записи или архивация гильдии не возвращает потраченные на неё очки.