diff --git a/README.md b/README.md index 850bd41..594f128 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ 已完结的文章会选中Checkbox。 -- [ ] [鉴权](other/authentication.md) +- [x] [绕过检测与鉴权](other/authentication.md) - [ ] [错误码](other/error_code.md) - [ ] [各种ID对照表](other/id.md) @@ -85,14 +85,24 @@ 查询玩家信息请查看[米游社](#米游社hoyolabmiyoushe)。 - [ ] [原神](genshin_impact) - - [ ] [登录](genshin_impact/login) + - [ ] [其它](genshin_impact/other/) - [ ] [公告](genshin_impact/other/announcement.md) +### 《崩坏:星穹铁道(Honkai: Star Rail,Star Rail)》 + +《崩坏:星穹铁道》游戏内的API。 + +查询玩家信息请查看[米游社](#米游社hoyolabmiyoushe)。 + +- [ ] [崩坏:星穹铁道](honkai_star_rail) + - [ ] [其它](honkai_star_rail/other/) + - [ ] [公告](honkai_star_rail/other/announcement.md) + + + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码
-100 请求参数`authkey`不正确

-108 未指定语言或不是支持的语言
-110 请求过快 | | +| message | str | 返回消息 | | +| data | obj | 该游戏账号的析愿信息 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| page | num | 页数 | 与请求参数中的`page`参数的值相同 | +| size | num | 该页的析愿记录数量 | | +| total | num | 0 | | +| list | arr | 析愿记录 | | +| region | str | 该账号所属服务器的标识 | | + +`data`对象→`list`数组→对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| uid | str | 该玩家的UID | | +| gacha_type | str | 析愿池 | 与请求参数中的`gacha_type`参数的值相同 | +| item_id | str | 似乎总是为空字符串 | | +| count | str | 1 | | +| time | str | 该玩家抽到该项目的日期 | | +| name | str | 抽到的项目名称 | 文本语言通过参数`lang`指定 | +| lang | str | 语言 | 与请求参数中的`lang`参数的值相同 | +| item_type | str | 该项目的类别 | 文本语言通过参数`lang`指定 | +| rank_type | str | 3 | | +| id | str | 似乎前10位数字为接近于抽到该项目的时间的Unix时间戳,后面的数字含义未知 | | + + +
+查看示例 + +```json +{ + "retcode": 0, + "message": "OK", + "data": { + "page": "0", + "size": "20", + "total": "0", + "list": [ + { + "uid": "222681079", + "gacha_type": "302", + "item_id": "", + "count": "1", + "time": "2023-04-21 20:54:19", + "name": "铁影阔剑", + "lang": "zh-cn", + "item_type": "武器", + "rank_type": "3", + "id": "1682078760003138679" + } + ], + "region": "cn_gf01" + } +} +``` +
+ + + +**国际服:** + +`未知` + +# 崩坏:星穹铁道 + +

获取首页信息

+ +**国服:** + +_请求方式:GET_ + +> _需要验证请求头_ +> +> `x-rpc-client_type`:`5` +> +> _需要验证网页Cookie_ + +`https://api-takumi-record.mihoyo.com/game_record/app/hkrpg/api/index` + +**参数:** + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| server | str | + + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码 | | +| message | str | 返回消息 | | +| data | obj | 玩家信息 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| stats | obj | 玩家基础信息 | | +| avatar_list | arr | 该玩家拥有的角色的基本信息 | | + +`data`对象→`stats`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| active_days | num | 该玩家的游玩天数 | | +| avatar_num | num | 该玩家拥有的角色数量 | | +| achievement_num | num | 该玩家已解锁的成就数量 | | +| chest_num | num | 该玩家已发现的战利品数量 | | +| abyss_process | str | 该玩家达成的忘却之庭层级 | | + +`data`对象→`avatar_list`数组→对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| id | num | 该角色的ID | | +| name | str | 角色名称 | | +| element | str | 该角色的元素属性 | 英文 | +| icon | str | 该角色的头像 | | +| rarity | num | 该角色的稀有度 | | +| rank | num | 待调查 | | +| is_chosen | bool | 是否收藏了该角色 | | + +
+查看示例 + +```json +{ + "retcode": 0, + "message": "OK", + "data": { + "stats": { + "active_days": 17, + "avatar_num": 15, + "achievement_num": 154, + "chest_num": 209, + "abyss_process": "回忆其六" + }, + "avatar_list": [ + { + "id": 1209, + "level": 60, + "name": "彦卿", + "element": "ice", + "icon": "https://uploadstatic.mihoyo.com/darkmatter/hkrpg/prod_gf_cn/item_icon_7a87fe/a5512decb10359dd6e1484085da105de.png", + "rarity": 5, + "rank": 0, + "is_chosen": false + }, + ... + ] + } +} +``` +
+ + + +**国际服:** + +`未知` + +

获取角色信息

+ +

获取忘却之庭信息

+ +

获取跃迁记录

+ +**国服:** + +_请求方式:GET_ + +`https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog` + +**参数:** + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| authkey_ver | num | 1 | | +| authkey | str | 验证密钥,用于标识游戏账号 | 打开“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”,寻找类似“https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……”的链接,该参数的值在其中 | +| lang | str | 语言,即返回数据中抽到的项目名称
zh-cn zh 简体中文
zh-tw 繁体中文
en-us en 英语
ru-ru ru 俄语
ja-jp ja 日语
以及其它国际语言代码 | | +| size | num | 返回数据中的最大数据数量 | | +| page | num | 页数,从1开始 | 若为负数返回则会是`-502`。若没有此参数,默认为第1页 | +| gacha_type | num | 跃迁池
1 群星跃迁
2 始发跃迁
11 角色活动跃迁
12 光锥活动跃迁 | | +| game_biz | str | hkrpc_cn | | + + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码
-100 请求参数`authkey`不正确
-111 请求参数`game_biz`不正确
-108 未指定语言或不是支持的语言
-110 请求过快 | | +| message | str | 返回消息 | | +| data | obj | 该游戏账号的析愿信息 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| page | num | 页数 | 与请求参数中的`page`参数的值相同 | +| size | num | 该页的跃迁记录数量 | | +| list | arr | 跃迁记录 | | +| region | str | 该账号所属服务器的标识 | | +| region_time_zone | num | 该玩家的所在时区的UTC时间偏移量 | | + +`data`对象→`list`数组→对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| uid | str | 该玩家的UID | | +| gacha_id | str | 待调查 | | +| gacha_type | str | 跃迁池 | | +| item_id | str | 该项目的ID | | +| count | str | 1 | | +| time | str | 该玩家抽到该项目的日期 | | +| name | str | 抽到的项目名称 | 文本语言通过参数`lang`指定 | +| lang | str | 语言 | 与请求参数中的`lang`参数的值相同 | +| item_type | str | 该项目的类别 | 文本语言通过参数`lang`指定 | +| rank_type | str | 3 | | +| id | str | 似乎前10位数字为接近于抽到该项目的时间的Unix时间戳,后面的数字含义未知 | | + + +
+查看示例 + +```json +{ + "retcode": 0, + "message": "OK", + "data": { + "page": "1", + "size": "1", + "list": [ + { + "uid": "108976226", + "gacha_id": "3003", + "gacha_type": "12", + "item_id": "20003", + "count": "1", + "time": "2023-05-07 15:15:27", + "name": "琥珀", + "lang": "zh-cn", + "item_type": "光锥", + "rank_type": "3", + "id": "1683443400001878626" + } + ], + "region": "prod_gf_cn", + "region_time_zone": 8 + } +} +``` +
+ + + +**国际服:** + +`未知` \ No newline at end of file diff --git a/other/error_code.md b/other/error_code.md index 8a84da0..c60f91a 100644 --- a/other/error_code.md +++ b/other/error_code.md @@ -8,7 +8,7 @@ | 错误码 | 消息 | 原因 | | ------------------------------ | ---- | --- | -| -10001 | invalid request | 该API需要验证请求头,请求头的`DS`字段缺失
请查看[鉴权](other/authentication.md#请求头) | -| -1 | param XXX error: value must be greater than X
param XXX error: value must be in list [X ...] | 传递的参数XXX缺失
传递的参数XXX的值只能在X、...中 | +| -10001 | invalid request | 该API需要验证请求头,请求头的`DS`字段缺失
请查看[绕过检测与鉴权](other/authentication.md) | +| -1 | param XXX error: value must be greater than X
param XXX error: value must be in list [X ...] | 传递的参数XXX缺失
传递的参数XXX的值只能是X、...中 | | 1008 | 用户信息不匹配 | 传递的参数不正确
(例如获取用户游戏账号信息的`role_id`为无效UID) | -| 10001 | Please login | 该API需要验证Cookie
请查看[鉴权](other/authentication.md#cookie) | \ No newline at end of file +| 10001 | Please login | 该API需要验证Cookie
请查看[绕过检测与鉴权](other/authentication.md#cookie) | \ No newline at end of file diff --git a/other/id.md b/other/id.md index e47f331..3a08ed0 100644 --- a/other/id.md +++ b/other/id.md @@ -15,6 +15,9 @@ - [原神](#原神) - [服务器名称](#genshin-server-region) - [角色ID](#genshin-characters) +- [崩坏:星穹铁道](#崩坏星穹铁道) + - [服务器名称](#star-rail-server-region) + - [角色ID](#star-rail-characters) --- @@ -52,7 +55,7 @@ | 26 | 酒馆 | | | 28 | 官方 | | | 29 | 同人图 | | -| 43 | 攻略 | | +| 43 | 攻略 | | | 49 | COS | | | 50 | 硬核 | | @@ -96,6 +99,7 @@ | 52 | 候车室 | | | 53 | 官方 | | | 56 | 同人图 | | +| 61 | 攻略 | |

绝区零

@@ -215,4 +219,31 @@ | 10000077 | 瑶瑶 | 草 | 璃月 | | 10000078 | 艾尔海森 | 草 | 须弥 | +## 崩坏:星穹铁道 + +

服务器名称

+ +| 名称 | 服务器 | 类别 | +| --- | ------ | ---- | +| prod_gf_cn | 官服 | 国服 | + +

角色ID

+ +| ID | 角色 | 命途 | 元素属性 | 阵营 | +| -- | --- | ---- | ---- | -------- | +| 1001 | 三月七 | 存护 | 冰 | 星穹列车 | +| 1002 | 丹恒 | 巡猎 | 风 | 星穹列车 | +| 1004 | 瓦尔特 | 虚无 | 虚数 | 星穹列车 | +| 1009 | 艾丝妲 | 同谐 | 火 | 空间站「黑塔」 | +| 1102 | 希儿 | 巡猎 | 量子 | 贝洛伯格 | +| 1103 | 希露瓦 | 智识 | 雷 | 贝洛伯格 | +| 1105 | 娜塔莎 | 丰饶 | 物理 | 贝洛伯格 | +| 1106 | 佩拉 | 虚无 | 冰 | 贝洛伯格 | +| 1108 | 桑博 | 虚无 | 风 | 贝洛伯格 | +| 1109 | 虎克 | 毁灭 | 火 | 贝洛伯格 | +| 1201 | 青雀 | 智识 | 量子 | 仙舟「罗浮」 | +| 1206 | 素裳 | 巡猎 | 物理 | 仙舟「罗浮」 | +| 1209 | 彦卿 | 巡猎 | 冰 | 仙舟「罗浮」 | +| 8002 | 开拓者 | | | 星穹列车 | +| 1013 | 黑塔 | 智识 | 冰 | 空间站「黑塔」 |