01. 简介
McServ API 允许服务器管理员检查用户在当前日历天内是否已投票。 投票在每天 00:00 (UTC) 重置。
02. 为什么使用 API?
防丢失可靠性
与可能因服务器离线而错过的 Votifier 通知不同,API 允许在玩家登录时进行按需验证。
商店与网页商城
在网页商城检查投票,以应用折扣或解锁购买,无需玩家在游戏内在线。
统计与仪表板
在您的网站或启动器上显示动态提醒,告诉玩家他们今天是否已经支持过服务器。
03. 获取您的 Slug
Slug 是您服务器 URL 中的永久文本标识符。它比数字 ID 更稳定,方便脚本维护。
mcserv.org/servers/slug_de_votre_serveur→ 从您的 McServ 公开 URL 中提取的标识符。
04. 访问端点
GET
slug/IP 地址响应 text/plain : 1 (已投票) 或 0 (未投票)。
GET
slug/IP 地址/json详细的 JSON 响应,包含时间戳和午夜重置信息。
响应预览:
{
"vote": "1",
"voted_at": "2026-02-05T14:20:01Z",
"reset": true,
"next_in": 34799
}