/ 接口详情
/ 接口详情
·
文字游戏
GET / POST
猜王者英雄
该接口以 “诗词 + 提示” 为线索，构建趣味十足的王者荣耀英雄猜谜玩法。精心编制超千组谜题，线索涵盖英雄台词、历史典故、技能机制等维度。如通过英雄曹操诗句 “横槊赋诗枭雄名 剑气叠霜血海腥 霸体开时天地肃 三分疆场任独行”，或其独特的技能特性提示，引导玩家猜出对应英雄。支持 GET/POST 请求，返回 JSON 格式数据，适用于游戏社区互动、文化答题小程序、品牌营销活动等场景，为用户带来知识与娱乐交融的全新体验。
调用 546 次
免费
无需 KEY
QPM 不限制
无需密钥
接口信息
GET / POST
xiaoapi.cn/v1/game_wz.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| id | string | 是 | 用户唯一标识，可为设备id等具有唯一性的值 | 1828222534 |
| msg | string | 是 | 游戏开始时需要输入“开始游戏<难度>”，如：开始游戏简单、开始游戏中等、开始游戏困难；也可直接输入所猜英雄，如瑶；<提示>时可获取当前英雄部分特性提示 | 开始游戏简单 |
[
{
"name": "id",
"type": "string",
"required": true,
"description": "用户唯一标识，可为设备id等具有唯一性的值",
"example": "1828222534"
},
{
"name": "msg",
"type": "string",
"required": true,
"description": "游戏开始时需要输入“开始游戏<难度>”，如：开始游戏简单、开始游戏中等、开始游戏困难；也可直接输入所猜英雄，如瑶；<提示>时可获取当前英雄部分特性提示",
"example": "开始游戏简单"
}
]
{"openapi":"3.1.1","info":{"title":"猜王者英雄","description":"该接口以 “诗词 + 提示” 为线索，构建趣味十足的王者荣耀英雄猜谜玩法。精心编制超千组谜题，线索涵盖英雄台词、历史典故、技能机制等维度。如通过英雄曹操诗句 “横槊赋诗枭雄名\r\n剑气叠霜血海腥\r\n霸体开时天地肃\r\n三分疆场任独行”，或其独特的技能特性提示，引导玩家猜出对应英雄。支持 GET/POST 请求，返回 JSON 格式数据，适用于游戏社区互动、文化答题小程序、品牌营销活动等场景，为用户带来知识与娱乐交融的全新体验。","version":"1.0.0"},"paths":{"/v1/game_wz.php":{"get":{"summary":"猜王者英雄","description":"该接口以 “诗词 + 提示” 为线索，构建趣味十足的王者荣耀英雄猜谜玩法。精心编制超千组谜题，线索涵盖英雄台词、历史典故、技能机制等维度。如通过英雄曹操诗句 “横槊赋诗枭雄名\r\n剑气叠霜血海腥\r\n霸体开时天地肃\r\n三分疆场任独行”，或其独特的技能特性提示，引导玩家猜出对应英雄。支持 GET/POST 请求，返回 JSON 格式数据，适用于游戏社区互动、文化答题小程序、品牌营销活动等场景，为用户带来知识与娱乐交融的全新体验。","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"用户唯一标识，可为设备id等具有唯一性的值"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"开始游戏简单"},"description":"游戏开始时需要输入“开始游戏<难度>”，如：开始游戏简单、开始游戏中等、开始游戏困难；也可直接输入所猜英雄，如瑶；<提示>时可获取当前英雄部分特性提示"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"猜王者英雄","description":"该接口以 “诗词 + 提示” 为线索，构建趣味十足的王者荣耀英雄猜谜玩法。精心编制超千组谜题，线索涵盖英雄台词、历史典故、技能机制等维度。如通过英雄曹操诗句 “横槊赋诗枭雄名\r\n剑气叠霜血海腥\r\n霸体开时天地肃\r\n三分疆场任独行”，或其独特的技能特性提示，引导玩家猜出对应英雄。支持 GET/POST 请求，返回 JSON 格式数据，适用于游戏社区互动、文化答题小程序、品牌营销活动等场景，为用户带来知识与娱乐交融的全新体验。","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"用户唯一标识，可为设备id等具有唯一性的值"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"开始游戏简单"},"description":"游戏开始时需要输入“开始游戏<难度>”，如：开始游戏简单、开始游戏中等、开始游戏困难；也可直接输入所猜英雄，如瑶；<提示>时可获取当前英雄部分特性提示"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口（http）"}]}
返回示例
{
"status": "success",
"message": "游戏开始！\n当前难度：简单\n请看题，下面是一首描写该英雄的诗词。",
"hint": "洛水凌波步生莲\n冰封千里玉指寒\n凝霜印记惊魂处\n泪化沧溟覆九天",
"remaining_hints": 5,
"guide": "请输入你猜测的英雄名称，或输入"提示"获取下一条线索"
}
详细文档
猜王者英雄
接口说明
提供以诗词和提示线索引导玩家猜测王者荣耀英雄的趣味猜谜接口，返回 JSON 格式数据。支持简单、中等、困难等多种难度模式，可通过输入“提示”获取英雄特性提示，适用于游戏社区互动、文化答题小程序及品牌营销活动等场景。
调用地址
https://xiaoapi.cn/v1/game_wz.php
请求方式
GET、POST
鉴权说明
无需密钥。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 用户唯一标识，可为设备 ID 等具有唯一性的值 |
| msg | string | 是 | 游戏指令或猜测内容 |
msg 参数取值说明
| 取值 | 说明 |
|---|---|
| 开始游戏简单 | 以简单难度开始游戏，谜题线索相对直接 |
| 开始游戏中等 | 以中等难度开始游戏，谜题线索有所增加 |
| 开始游戏困难 | 以困难难度开始游戏，谜题线索更具挑战性 |
| 英雄名称 | 直接输入所猜英雄名称进行作答 |
| 提示 | 获取当前英雄的部分特性提示，每次提示会消耗剩余次数 |
成功响应示例
{
"status": "success",
"message": "游戏开始！\n当前难度：简单\n请看题，下面是一首描写该英雄的诗词。",
"hint": "洛水凌波步生莲\n冰封千里玉指寒\n凝霜印记惊魂处\n泪化沧溟覆九天",
"remaining_hints": 5,
"guide": "请输入你猜测的英雄名称，或输入\"提示\"获取下一条线索"
}响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| status | string | 接口调用状态，返回 success 表示请求成功 |
| message | string | 游戏状态描述信息，说明当前游戏进程与提示 |
| hint | string | 当前谜题的诗词或特征描述，用于引导玩家猜出英雄 |
| remaining_hints | int | 剩余提示次数，随着使用提示递减，为 0 时不可再获取提示 |
| guide | string | 操作指引，说明可输入猜测的英雄名称或使用提示功能 |
错误响应示例
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}{
"code": 0,
"msg": "积分余额不足",
"errcode": 11004
}{
"code": 0,
"msg": "请求过于频繁，请稍后重试",
"errcode": 11005
}业务错误码说明
| errcode | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁（QPM 限制） |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
调用示例
终端 curl（bash）
curl -X POST "https://xiaoapi.cn/v1/game_wz.php" \
-d "id=1828222534" \
-d "msg=开始游戏简单"PHP
// PHP
$url = "https://xiaoapi.cn/v1/game_wz.php";
$data = array(
"id" => "1828222534",
"msg" => "开始游戏简单"
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;注意事项
-
请求方式：GET 与 POST 均支持，POST 建议使用 JSON 格式请求体以获得更好的参数兼容性。
-
msg参数格式：- 首次进入需发送
开始游戏简单、开始游戏中等或开始游戏困难启动游戏，难度与题目数量、提示难度相关； - 游戏中输入任意英雄名（如“瑶”）即可作答；
- 输入“提示”可获取当前题目的额外线索，但剩余提示次数有限。
- 首次进入需发送
-
id参数唯一性：id用于标识用户身份与游戏状态，需保证全局唯一（如使用设备 UUID），重复使用不同id会导致游戏状态丢失或混淆。 -
会话状态维护：游戏进度依赖于
id与服务端状态关联，中途更换id将无法继续当前游戏，需重新开始。 -
返回数据构成：成功响应包含
status、message（当前状态说明）、hint（谜面线索）、remaining_hints（剩余提示次数）、guide（操作指引），需根据status判断请求是否成功。 -
提示次数消耗：每次输入“提示”会扣减
remaining_hints，耗尽后无法再获取线索，建议在确实无法作答时再使用。 -
网络环境：建议在 HTTPS 环境下调用，避免中间网络环节干扰数据传输。
快速上手
curl -s "https://xiaoapi.cn/v1/game_wz.php?id=1828222534&msg=开始游戏简单"
curl -s -X POST "https://xiaoapi.cn/v1/game_wz.php" -d "id=1828222534&msg=开始游戏简单"
curl -s "https://xiaoapi.cn/v1/game_wz.php?id=1828222534&msg=提示"在线测试
请求地址
xiaoapi.cn/v1/game_wz.php
Method
参数
Response
// 结果将在此处显示
接口反馈
推荐接口
