よくある質問
Uppercut GGでのサーバー認証、Webhook、投票報酬の仕組み
サーバー認証
サーバーは1つ以上のアカウントに割り当てることができます。認証は、所有者として記載された人がサーバーのウェブサイトを管理していることを証明します。
認証は記載されたアカウントをサーバーに紐付け、あなたがそのウェブサイトを管理していることを確認します。認証済みサーバーは公開ページに認証バッジを表示します。
認証ファイル
サイトURLの、そのパスが示すディレクトリにJSONファイルを配置してください。例えばhttps://example.com/wikiのようなサイトURLの場合、https://example.com/wiki/uppercutgg-….jsonにファイルをホストします。正確なURLはサーバーの編集ページと公開ページに表示されます。
uppercutgg-{fingerprint}.json
ファイル名はサイトURL(ホスト名とパス)に基づきます。想定されるファイル名とホスティング用の完全なURLは、サーバーの編集ページと公開詳細ページに表示されます。
JSON形式
ファイルは、アカウントID(最大10件)を列挙したowner_account_ids配列を持つserverオブジェクトを含む有効なJSONである必要があります:
{
"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日あたり1,000ポイントまでです。1日の上限に達すると、追加の投票はサーバーには登録されますが、翌日(UTC)まではそれ以上のポイントを獲得できません。
ポイントの利用
獲得したポイントは、あなたが管理するギルドやサーバーの宣伝に使えます。
ギルドを上位表示するには100ポイントが必要で、ギルドディレクトリの先頭に移動します。ギルドは12時間に一度だけ上位表示できます。
投稿の公開には150ポイントが必要です。下書きは無料で、各投稿の公開にかかる料金は一度だけです — 非公開にして再度公開しても追加料金はかかりません。
サーバー投稿も同じ仕組みで150ポイントかかりますが、1点だけ違いがあります。公開できるのは認証済みのサーバーだけです。下書きの作成は無料で、いつでも利用できます。 サーバー認証の仕組み
投稿に絵文字でリアクションすると、その絵文字を初めて使うときに25ポイントが必要です。その後は無料でリアクションのオン・オフを切り替えられます。
ポイントは返還されません。投稿の削除やギルドのアーカイブを行っても、それに使用したポイントは返還されません。