01. はじめに
McServ APIを使用すると、管理者はユーザーが当日に投票したかどうかを確認できます。 投票は毎日 00:00 (UTC) にリセットされます。
02. APIを利用する理由
損失防止の信頼性
サーバーがオフラインだと見逃される可能性があるVotifier通知とは異なり、APIではプレイヤーのログイン時にオンデマンドで検証が可能です。
ウェブストア対応
プレイヤーがゲームに接続していなくても、ストア上で投票を確認して割引や特典を付与できます。
統計とダッシュボード
サイトやランチャーに動的なリマインダーを表示し、プレイヤーが今日すでにサポート済みかどうかを知らせることができます。
03. スラグの取得
スラグとは、サーバーURLに含まれる永続的なテキスト識別子です。数字IDよりも安定しており、スクリプトのメンテナンスが容易になります。
mcserv.org/servers/slug_de_votre_serveur→ McServの公開URLから抽出する識別子です。
04. アクセスポイント
GET
スラグ/IPレスポンス text/plain : 1 (投票済み) または 0 (未投票)。
GET
スラグ/IP/jsonタイムスタンプとリセット時間を含む詳細なJSONレスポンス。
レスポンス・プレビュー:
{
"vote": "1",
"voted_at": "2026-02-05T14:20:01Z",
"reset": true,
"next_in": 34799
}