Home - ELDment/TEA-api-docs GitHub Wiki

📜 杂类数据

获取QQ群

/api/qqgroup

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
qqgroup str QQ群号

示例：

curl --request GET 'https://api.teahvh.cc/api/qqgroup'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": {
    "qqgroup": "965674939"
  },
  "timestamp": 1747127503
}

获取公告

/api/announcement

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
- arr 数组

示例：

curl --request GET 'https://api.teahvh.cc/api/announcement'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "timer": 360,
      "content": [
        "我们正在推进社区插件重构，更多玩法敬请期待！",
        "核心框架已完成测试，玩法性插件即将启动全量测试。"
      ]
    },
    {
      "timer": 150,
      "content": [
        "茶社 —— 技术架构深度迭代，HVH娱乐生态领航者。",
        "如有游玩问题或玩法建议，请联系服务器管理员。"
      ]
    },
    {
      "timer": 60,
      "content": [
        "聊天记录已存档，请勿发送敏感、违法、违规信息。"
      ]
    }
  ],
  "timestamp": 1747129620
}

⚡️ 服务器数据

获取服务器数据

/api/server/{port}

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
players num 在线玩家数量
bots num 在线机器人数量
maxplayers num 最大玩家数量
map str 地图名
name str 服务器名称 服务器实际名称
online arr 在线玩家数组

示例：

curl --request GET 'https://api.teahvh.cc/api/server/27030'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": {
    "players": 11,
    "bots": 0,
    "maxplayers": 32,
    "map": "de_mirage_cyberpunk",
    "name": "【茶】🏹 鸟狙魔怔 #1 | 官方群聊：965674939",
    "online": [
      {
        "name": "Y1Zhong&Crack#508",
        "steam": "STEAM_1:0:660471669"
      },
      {
        "name": "dark psychology#155",
        "steam": "STEAM_1:0:696314679"
      },
      {
        "name": "茶社新用户#851",
        "steam": "STEAM_1:0:566716956"
      },
      {
        "name": "LegendMiss#154",
        "steam": "STEAM_1:0:233883072"
      },
      {
        "name": "18888skcfg+185734230#585",
        "steam": "STEAM_1:1:710684238"
      },
      {
        "name": "Sands#141",
        "steam": "STEAM_1:1:541287431"
      },
      {
        "name": "茶社新用户#863",
        "steam": "STEAM_1:0:782795603"
      },
      {
        "name": "W#110",
        "steam": "STEAM_1:0:858002447"
      },
      {
        "name": "空枪组-LING#51",
        "steam": "STEAM_1:1:930935817"
      },
      {
        "name": "Red#138",
        "steam": "STEAM_1:1:799732248"
      },
      {
        "name": "As-CK#33",
        "steam": "STEAM_1:1:687316964"
      }
    ]
  },
  "timestamp": 1748355600
}

☕️ 【茶】社数据

获取玩家数据（使用teaId）

/api/users/id/{teaId}

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
teaid num teaId 计分板中显示
steam str steam32
online num 总在线时长 单位：秒
last_login num 最后一次上线
muted_until num 禁麦解除时间
muted_times num 被禁麦次数
banned_until num 封禁解除时间
banned_times num 被封禁次数
guild num 行会Id
tags num 拥有的标签 拥有的标签按位或的结果
tag_equipped num 装备的标签 管理员：1 << 0
高级玩家：1 << 1
行会：1 << 2

自定义标签：1 << n （ n ∈ [11, 25] ）

示例：

curl --request GET 'https://api.teahvh.cc/api/users/id/1'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": {
    "teaid": 1,
    "steam": "STEAM_1:0:603999025",
    "online": 247926,
    "last_login": 1747120664,
    "muted_until": 0,
    "muted_times": 0,
    "banned_until": 1747111490,
    "banned_times": 8,
    "guild": 0,
    "tags": 1,
    "tag_equipped": 1
  },
  "timestamp": 1747128787
}

获取玩家数据（使用steam32）

/api/users/{steam32}

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
teaid num teaId 计分板中显示
steam str steam32
online num 总在线时长 单位：秒
last_login num 最后一次上线
muted_until num 禁麦解除时间
muted_times num 被禁麦次数
banned_until num 封禁解除时间
banned_times num 被封禁次数
guild num 行会Id
tags num 拥有的标签 拥有的标签按位或的结果
tag_equipped num 装备的标签 管理员：1 << 0
高级玩家：1 << 1
行会：1 << 2

自定义标签：1 << n （ n ∈ [11, 25] ）

示例：

curl --request GET 'https://api.teahvh.cc/api/users/STEAM_1:0:603999025'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": {
    "teaid": 1,
    "steam": "STEAM_1:0:603999025",
    "online": 247926,
    "last_login": 1747120664,
    "muted_until": 0,
    "muted_times": 0,
    "banned_until": 1747111490,
    "banned_times": 8,
    "guild": 0,
    "tags": 1,
    "tag_equipped": 1
  },
  "timestamp": 1747128787
}

获取玩家装备的MVP赞歌

/api/mvpanthem/{steam32}

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
steam str steam32
name str 装备MVP赞歌
volume num 收听音量 百分比

示例：

curl --request GET 'https://api.teahvh.cc/api/mvpanthem/STEAM_1:0:603999025'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": {
    "steam": "STEAM_1:0:603999025",
    "name": "ニッポン笑顔百景"
  },
  "timestamp": 1747129931
}

🉐 Levelrank数据

获取Levelrank TOP榜

https://api.teahvh.cc/api/levelrank/top?limit=

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
- arr 数据键

示例：

curl -X GET 'https://api.teahvh.cc/api/levelrank/top?limit=10'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "top": 1,
      "rank_value": 124982,
      "nickname": "Drachengott#116",
      "steam": "STEAM_1:0:465906920",
      "headshot_rate": "0.0436",
      "kd": "1.79",
      "mvp_rate": "0.00",
      "online_hours": "32.2",
      "last_online": "5天前"
    },
    {
      "top": 2,
      "rank_value": 94553,
      "nickname": "茶社新用户#454",
      "steam": "STEAM_1:1:613526803",
      "headshot_rate": "0.0314",
      "kd": "1.61",
      "mvp_rate": "0.00",
      "online_hours": "0.9",
      "last_online": "9天前"
    },
    {
      "top": 3,
      "rank_value": 55425,
      "nickname": "15kiss#20",
      "steam": "STEAM_1:1:633739258",
      "headshot_rate": "0.0565",
      "kd": "1.60",
      "mvp_rate": "0.02",
      "online_hours": "7.3",
      "last_online": "2天前"
    },
    {
      "top": 4,
      "rank_value": 45709,
      "nickname": "仔仔熊#247",
      "steam": "STEAM_1:0:926166103",
      "headshot_rate": "0.2030",
      "kd": "2.05",
      "mvp_rate": "0.04",
      "online_hours": "5.4",
      "last_online": "6天前"
    },
    {
      "top": 5,
      "rank_value": 42971,
      "nickname": "1#593",
      "steam": "STEAM_1:0:857859378",
      "headshot_rate": "0.1302",
      "kd": "1.35",
      "mvp_rate": "0.02",
      "online_hours": "4.9",
      "last_online": "2天前"
    },
    {
      "top": 6,
      "rank_value": 32874,
      "nickname": "Gamesence.cc#DLL大蛇#15",
      "steam": "STEAM_1:1:913654978",
      "headshot_rate": "0.2014",
      "kd": "1.40",
      "mvp_rate": "0.20",
      "online_hours": "28.0",
      "last_online": "3小时前"
    },
    {
      "top": 7,
      "rank_value": 32664,
      "nickname": "vjqdt8125#6",
      "steam": "STEAM_1:1:902997382",
      "headshot_rate": "0.1062",
      "kd": "0.96",
      "mvp_rate": "0.11",
      "online_hours": "63.2",
      "last_online": "5小时前"
    },
    {
      "top": 8,
      "rank_value": 31937,
      "nickname": "Unnamed#202",
      "steam": "STEAM_1:1:614708439",
      "headshot_rate": "0.0922",
      "kd": "2.05",
      "mvp_rate": "0.01",
      "online_hours": "5.6",
      "last_online": "3天前"
    },
    {
      "top": 9,
      "rank_value": 31079,
      "nickname": "Ты мне нравишься#159",
      "steam": "STEAM_1:1:633302014",
      "headshot_rate": "0.1301",
      "kd": "1.54",
      "mvp_rate": "0.04",
      "online_hours": "12.2",
      "last_online": "1天前"
    },
    {
      "top": 10,
      "rank_value": 31030,
      "nickname": "猫#241ㅤ#368",
      "steam": "STEAM_1:0:768303180",
      "headshot_rate": "0.0787",
      "kd": "1.32",
      "mvp_rate": "0.00",
      "online_hours": "7.4",
      "last_online": "1天前"
    }
  ],
  "timestamp": 1748514394
}

获取玩家积分数据

/api/users/{steam32}

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
steam str steam32
name str 游戏内名称 计分板中显示
value num 总积分
rank num 等级
kills num 击杀数 自杀不计入
shoots num 射击次数
hits num 命中次数
headshots num 爆头次数
assists num 助攻次数
wins num 回合获胜次数
lose num 回合失败次数
mvps num 获取回合MVP次数
plant num 安防炸弹次数 玩家为T时
explode num 安放的炸弹成功爆炸次数 玩家为T时
defuse num 拆除炸弹次数 玩家为CT时
defused num 安放的炸弹被拆除次数 玩家为T时

示例：

curl --request GET 'https://api.teahvh.cc/api/levelrank/STEAM_1:0:603999025'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": {
    "steam": "STEAM_1:0:603999025",
    "name": "ELDment#1",
    "value": 5723,
    "rank": 0,
    "kills": 319,
    "deaths": 99,
    "shoots": 0,
    "hits": 330,
    "headshots": 248,
    "assists": 0,
    "wins": 389,
    "lose": 530,
    "mvps": 137,
    "plant": 19,
    "explode": 10,
    "defuse": 0,
    "defused": 0
  },
  "timestamp": 1747130037
}

获取玩家积分排行

/api/levelrank/order/{steam32}

请求方式：GET

认证方式：无

正文参数：无

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 200：表示成功
message str 信息
data obj 数据本体
timestamp（可空） num 响应时间

data对象：

字段 类型 内容 备注
ranking num 全服排行

示例：

curl --request GET 'https://api.ambr0se.xyz/api/levelrank/order/STEAM_1:0:603999025'
查看响应示例： 
{
  "code": 200,
  "message": "success",
  "data": {
    "ranking": 4183
  },
  "timestamp": 1747553439
}
⚠️ **GitHub.com Fallback** ⚠️