VoteServeur API v1

カタログ内 68 ゲームの投票報酬。どこでも同じ API：server_token + 単一の identity フィールド（ユーザー名、Steam または Discord — 自動検出）。

ベース URL

https://voteserveur.fr/api/v1

JSON UTF-8。IPレート制限：公開読み取りエンドポイントは約90 req/分。claimはより厳しい。

認証

server_token（40–64文字）は所有者（サーバー管理）のみ表示。秘密にしてください。

• Query：?server_token=TOKEN
• Header：X-Server-Token: TOKEN
• Header：Authorization: Bearer TOKEN

有効なトークンなし → 404（スラッグの有無は明かさない）。

プレイヤーの流れ（ステップ）

1. /ja/serveurs/nouveau でサーバー登録を作成。
2. /ja/plugins/{game} でパックをダウンロード（トークン済み）。
3. プラグインをインストール / ポーラーを起動（ZIP内の INSTALL.txt を参照）。推奨間隔：10分。
4. プレイヤーは報酬チェックを入れて1つの識別子（ユーザー名 / Discord / Steam）を入力して投票 — claimコードを受け取ります（例 /vsclaim ABC123）。
5. スクリプトが GET /votes/pending、次に GET /votes/claim?identity=… を呼び出し → claimed = 1 なら報酬を1回だけ付与。claim-code でも可。
6. 任意：月次ティア用に votes/player（5 / 10 / 30票…）。

GET /votes/claim (推奨)

統合claim：1つの identity パラメータ。APIがユーザー名 / SteamID64 / Discord を自動判定。claim-username / claim-steam / claim-discord も利用可（互換）。

GET https://voteserveur.fr/api/v1/votes/claim?server_token=TOKEN&identity=Pseudo
GET https://voteserveur.fr/api/v1/votes/claim?server_token=TOKEN&identity=76561198000000000
GET https://voteserveur.fr/api/v1/votes/claim?server_token=TOKEN&identity=123456789012345678

従来のclaimと同じ claimed 0 / 1 / 2 スキーマ。

GET /votes/claim-username

ユーザー名または姓名で直近2時間の投票を請求。投票の注入は不可。

GET https://voteserveur.fr/api/v1/votes/claim-username?server_token=TOKEN&playername=Pseudo
GET https://voteserveur.fr/api/v1/votes/claim-username?server_token=TOKEN&playername=Jean%20Dupont

{
  "code": 200,
  "success": true,
  "claimed": 1,
  "message": "投票を請求済み"
}

• claimed: 0 — 対象の投票なし
• claimed: 1 — 今請求 → 報酬を付与
• claimed: 2 — 既に請求済み

ユーザー名の揺れ（Bob、Bob!、B o b、Jean Dupont / JeanDupont）は同一プレイヤーとして統合。

GET /votes/claim-steam

GET https://voteserveur.fr/api/v1/votes/claim-steam?server_token=TOKEN&steam_id=76561198000000000

claim-username と同じ応答スキーマ。

GET /votes/claim-discord

Discord ID（17–20桁のsnowflake）で請求。Discord、Discord連携Habbo、ボットなどに便利。

GET https://voteserveur.fr/api/v1/votes/claim-discord?server_token=TOKEN&discord_id=123456789012345678

メンション形式 <@123…> も可。claim-username と同じ応答スキーマ。

GET /votes/claim-code

投票後に表示されるワンショットコードで請求（6文字・2時間有効）。推奨ゲーム内コマンド：/vsclaim ABC123。

GET https://voteserveur.fr/api/v1/votes/claim-code?server_token=TOKEN&code=ABC123

同じ claimed 0/1/2 スキーマ。投票にユーザー名があれば応答に playername を含む場合あり。

GET /votes/check

消費せず確認：0 未投票 · 1 請求済み · 2 投票済み未請求。

GET https://voteserveur.fr/api/v1/votes/check?server_token=TOKEN&playername=Pseudo

GET /votes/check-steam

GET https://voteserveur.fr/api/v1/votes/check-steam?server_token=TOKEN&steam_id=7656119…

GET /votes/check-discord

GET https://voteserveur.fr/api/v1/votes/check-discord?server_token=TOKEN&discord_id=123456789012345678

GET /votes/check-ip

HTTPクライアントIPに最近の投票があるか（プラグイン側の不正防止）。トークン必須。

GET https://voteserveur.fr/api/v1/votes/check-ip?server_token=TOKEN

GET /votes/last

直近の投票（約1時間枠）— デバッグ / Discordオーバーレイ。

GET https://voteserveur.fr/api/v1/votes/last?server_token=TOKEN

GET /votes/pending

claim枠（2時間）内の未請求投票（報酬チェック済み）。サーバー全体で1リクエスト — 約10分ごとにポーリング — APIは未請求投票者を一括返却。

GET https://voteserveur.fr/api/v1/votes/pending?server_token=TOKEN&limit=50

{
  "success": true,
  "votes": [
    { "id": "…", "playername": "Pseudo", "steam_id": null, "discord_id": "123…", "created_at": "…", "created_ts": 1710000000 }
  ]
}

続けて一致するオンラインプレイヤーごとに claim?identity=… を呼ぶ。

GET /votes/top

集計プレイヤーランキング。Params：period=month|day|all、limit（最大50）。

GET https://voteserveur.fr/api/v1/votes/top?server_token=TOKEN&period=month&limit=10

GET /votes/player (別名 /votes/stats)

プレイヤー統計（月 / 累計）— ユニバーサルポーラーのティア向け。

GET https://voteserveur.fr/api/v1/votes/player?server_token=TOKEN&playername=Pseudo
GET https://voteserveur.fr/api/v1/votes/stats?server_token=TOKEN&steam_id=7656119…

{
  "success": true,
  "player_name": "Pseudo",
  "votes_month": 12,
  "votes_total": 48
}

GET /server

トークンに紐づく公開サーバー情報。

GET https://voteserveur.fr/api/v1/server?server_token=TOKEN

GET /servers/{token}

パス版：/servers/{token}、/full、/stats、/advices、/players-ranking。

GET https://voteserveur.fr/api/v1/servers/TOKEN
GET https://voteserveur.fr/api/v1/servers/TOKEN/full
GET https://voteserveur.fr/api/v1/servers/TOKEN/stats
GET https://voteserveur.fr/api/v1/servers/TOKEN/advices
GET https://voteserveur.fr/api/v1/servers/TOKEN/players-ranking

コードとエラー

• 200 — OK（claimed: 0 でも）
• 400 — パラメータ不足 / 無効
• 404 — 不明なトークン
• 429 — レート制限

スクリプトとプラグイン

各ゲーム向けZIPパック（ネイティブおよび/またはユニバーサルポーラー）、トークン注入済み、所有者専用：

• プラグイン一覧 — ゲームごとのインストールガイド
• GTA：同一ZIPに FiveM + RageMP + SA-MP
• サーバー手順ガイド：/ja/guides

curlの例

# Claim
curl -s -H 'X-Server-Token: TOKEN' \
  'https://voteserveur.fr/api/v1/votes/claim-username?playername=Nayvroxi'

# 月次統計（ティア）
curl -s -H 'X-Server-Token: TOKEN' \
  'https://voteserveur.fr/api/v1/votes/player?playername=Nayvroxi'