接口总览
本兼容层保留旧域名旧接口路径，自动转换请求格式对接新版UniteBan原生API。仅开放封禁查询功能，上传/服务器注册接口仅模拟响应，无数据提交。
说明：本文档仅描述API调用规范，不含网站部署、插件安装教程。
功能状态
- ✅ 可用：封禁查询接口 /api.php
接收POST JSON玩家数据，自动转换为GET参数调用新版查询接口，返回旧标准JSON
- ❌ 禁用：上传/注册接口 /innerapi.php
接收任意参数，固定返回成功，不转发任何新版写入接口
接口1：封禁查询 /api.php
基础信息
- 请求地址：https://uniteban.mxzc.top/api.php
- 请求方式：POST
- 请求头：Content-Type: application/json
- 作用：玩家进服连锁封禁校验，多标识OR匹配
客户端请求JSON参数
- xuid string 选填 基岩玩家XUID
- clientid string 选填 设备ClientID
- ip string 选填 玩家公网IP
- name、uuid 会被兼容层丢弃，新版查询接口不支持
- 至少传入任意一项标识参数
客户端请求示例
POST https://uniteban.mxzc.top/api.php
Content-Type: application/json
{
"name": "TestPlayer",
"xuid": "25354176842148",
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"clientid": "abc123def",
"ip": "114.5.14.22"
}
兼容层返回格式
玩家已被封禁
{
"exists": true,
"reason": "使用外挂"
}
玩家未被封禁
{
"exists": false,
"reason": "无封禁记录"
}
接口2：上传/服务器注册 /innerapi.php
基础信息
- 请求地址：https://uniteban.mxzc.top/innerapi.php
- 请求方式：POST
- 状态：功能强制关闭，仅模拟响应
无论传入mac、token、玩家信息等任何参数，不会发起外网请求，固定返回统一成功JSON。
固定返回内容
{
"status": "success",
"message": "上传、服务器注册功能已永久关闭"
}
在线API测试面板
封禁查询测试（JSON请求体）
完整原始响应结果
旧版客户端插件下载
所有基于旧UniteBan API开发的插件，可直接对接本兼容层接口，无需修改代码。
前往下载旧版插件