永劫搜索玩家
搜索永劫无间玩家,按昵称或游戏ID查询,返回角色ID和段位。推荐使用游戏ID搜索,命中率更高。
GET
https://api.tinyaii.cn/v1/naraka/search
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| name | string | 必填 | 玩家昵称(需URL编码)或游戏ID(数字) | 残星 |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| data.gameUserId | int | 游戏用户ID |
| data.roleIdSimple | string | 角色ID(用于查询战绩/对局) |
| data.roleName | string | 玩家昵称 |
| data.avatar | string | 头像链接 |
| data.dataSource | string | 数据来源(heyBox/miniProgram) |
| data.levelName | string | 段位名称 |
| data.levelImg | string | 段位图标 |
返回示例
{
"code": 200,
"data": {
"avatar": "https://imgheybox.max-c.com/app/heybox/naraka/player_icon/3430025.png",
"dataSource": "heyBox",
"gameUserId": 1516156134528765952,
"levelImg": "https://imgheybox.max-c.com/app/heybox/naraka/rankv2/1000.png",
"levelName": "青铜Ⅴ",
"roleId": null,
"roleIdMiniProgram": null,
"roleIdSimple": "349200070163",
"roleLevel": 0,
"roleName": "残星"
},
"message": "success"
}
调用示例
curl "https://api.tinyaii.cn/v1/naraka/search?name=残星" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/naraka/search?name=残星", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/naraka/search",
params={"name": "残星"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。