From fd63a292d9c80fd877b74635b6e3922306833558 Mon Sep 17 00:00:00 2001 From: Kamisato-Ayaka-233 <2627706725@qq.com> Date: Fri, 25 Aug 2023 22:33:17 +0800 Subject: [PATCH] =?UTF-8?q?=E3=80=90A=E3=80=91=E2=80=9C=E6=B8=B8=E6=88=8F?= =?UTF-8?q?=E8=B4=A6=E5=8F=B7=E4=BF=A1=E6=81=AF=E2=80=9D=E5=A2=9E=E5=8A=A0?= =?UTF-8?q?=E9=83=A8=E5=88=86=E7=94=A8=E4=BA=8E=E8=8E=B7=E5=8F=96=E7=BB=91?= =?UTF-8?q?=E5=AE=9A=E6=B8=B8=E6=88=8F=E8=B4=A6=E5=8F=B7=E5=9F=BA=E6=9C=AC?= =?UTF-8?q?=E4=BF=A1=E6=81=AF=E6=8E=A5=E5=8F=A3=20=E3=80=90A=E3=80=91?= =?UTF-8?q?=E2=80=9CID=E5=AF=B9=E7=85=A7=E8=A1=A8=E2=80=9D=E5=A2=9E?= =?UTF-8?q?=E5=8A=A0=E5=B4=A9=E5=9D=8F3=E7=9A=84=E9=83=A8=E5=88=86?= =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E5=99=A8=E5=90=8D=E7=A7=B0=20=E3=80=90A?= =?UTF-8?q?=E3=80=91=E2=80=9CID=E5=AF=B9=E7=85=A7=E8=A1=A8=E2=80=9D?= =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E9=83=A8=E5=88=86=E6=B8=B8=E6=88=8F=E6=A0=87?= =?UTF-8?q?=E8=AF=86=E7=AC=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- hoyolab/forum/info.md | 2 +- hoyolab/user/game_account_info.md | 300 ++++++++++++++++++++++++++++++ hoyolab/user/info.md | 1 + other/id.md | 20 ++ 5 files changed, 323 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 419acb0..9383ebe 100644 --- a/README.md +++ b/README.md @@ -68,7 +68,7 @@ - [x] [绕过检测与鉴权](other/authentication.md) - [ ] [错误码](other/error_code.md) - [ ] [各种ID对照表](other/id.md) -- [ ] [游戏启动器信息](other/launcher.md) +- [x] [游戏启动器信息](other/launcher.md) --- ### 米游社（HoYoLab，MiYouShe） diff --git a/hoyolab/forum/info.md b/hoyolab/forum/info.md index 8d2fe57..0a43a9d 100644 --- a/hoyolab/forum/info.md +++ b/hoyolab/forum/info.md @@ -59,7 +59,7 @@ _请求方式：GET_ | post_order | str | 默认排序类型
reply 最新回复 | | | src_type | num | 待调查 | | | icon | str | 分区图标 | | -| header_image | str | 分区头图 | APP端头部部分 | +| header_image | str | 分区头图URL | APP端头部部分 | | hot_score | num | 待调查 | | | icon_pure | str | 分区图标 | | | des | str | 描述 | | diff --git a/hoyolab/user/game_account_info.md b/hoyolab/user/game_account_info.md index 1e5ff1e..0858494 100644 --- a/hoyolab/user/game_account_info.md +++ b/hoyolab/user/game_account_info.md @@ -1,5 +1,8 @@ # 游戏账号信息 +- [获取游戏记录卡片信息](#获取游戏记录卡片信息) +- [通过LToken获取绑定游戏账号的基本信息](#通过ltoken获取绑定游戏账号的基本信息) +- [通过SToken获取绑定游戏账号的基本信息](#通过stoken获取绑定游戏账号的基本信息) - [原神](#原神) - [获取首页信息](#genshin-home) - [获取角色信息](#genshin-characters) @@ -14,6 +17,303 @@ --- +## 获取游戏记录卡片信息 + +**国服：** + +_请求方式：GET_ + +> _需要验证请求头_ +> +> `x-rpc-client_type`：`2` +> +> K2`salt` +> +> `DS1` + +> _需要验证Cookie_ +> +> SToken + +`https://api-takumi-record.mihoyo.com/game_record/card/api/getGameRecordCard` + +**参数：** + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| uid | str | 想要获取游戏记录卡片信息的米游社账号ID | | + +**JSON返回：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码 | | +| message | str | 返回消息 | | +| data | obj | 该米游社账号的所有游戏记录卡片信息 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| list | arr | 所有游戏记录卡片信息 | | + +`data`对象→`list`数组→对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| has_role | bool | 该账号是否已绑定该游戏的任何账号 | | +| game_id | num | 该游戏记录对应的游戏ID | | +| game_role_id | str | 该游戏记录展示的游戏账号ID | | +| nickname | str | 该游戏账号的昵称 | | +| region | str | 该游戏账号所属服务器的名称 | | +| level | num | 该游戏账号的等级 | 例如原神的冒险等级 | +| background_image | str | 该游戏记录卡片背景图片的URL | | +| is_public | bool | 该账号是否公开该游戏记录 | | +| data | arr | 该游戏记录的一些简略信息 | | +| region_name | str | 该游戏账号所属服务器的称呼 | | +| url | str | 该游戏记录卡片将跳转页面的URL | | +| data_switches | arr | 待调查 | | +| h5_data_switches | arr | 待调查 | | +| background_color | str | 该卡片背景颜色的16进制颜色值 | | + +`data`对象→`list`数组→对象→`data`数组→对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| name | str | 该记录项的名称 | | +| type | num | 待调查 | | +| value | str | 该记录项的数据 | | + +`data`对象→`list`数组→对象→`data_switches`数组→对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| switch_id | str | 待调查 | | +| is_public | bool | 待调查 | | +| switch_name | str | 待调查 | | + +
+查看示例 + +```json +{ + "retcode": 0, + "message": "OK", + "data": { + "list": [ + { + "has_role": true, + "game_id": 2, + "game_role_id": "222681079", + "nickname": "※青衫入雨※", + "region": "cn_gf01", + "level": 59, + "background_image": "https://upload-bbs.mihoyo.com/upload/2020/09/22/0762ab7cc42ac5a760bb4d1ea87b2c42_1236712390449986860.png", + "is_public": true, + "data": [ + { + "name": "活跃天数", + "type": 1, + "value": "524" + }, + { + "name": "获得角色数", + "type": 1, + "value": "53" + }, + { + "name": "成就达成数", + "type": 1, + "value": "795" + }, + { + "name": "深境螺旋", + "type": 1, + "value": "8-3" + } + ], + "region_name": "天空岛", + "url": "https://webstatic.mihoyo.com/app/community-game-records/?bbs_presentation_style=fullscreen&bbs_auth_required=true&v=101&gid=2&user_id=317832114", + "data_switches": [ + { + "switch_id": 1, + "is_public": true, + "switch_name": "个人主页卡片" + }, + { + "switch_id": 2, + "is_public": true, + "switch_name": "角色详情数据" + } + ], + "h5_data_switches": [], + "background_color": "D3BC8E" + }, + ... + ] + } +} +``` +
+ +## 通过LToken获取绑定游戏账号的基本信息 + +**国服：** + +_请求方式：GET_ + +> _需要验证请求头_ +> +> `x-rpc-client_type`：`5` +> +> 4X`salt` +> +> `DS2` + +> _需要验证Cookie_ +> +> LToken + +`https://api-takumi.mihoyo.com/binding/api/getUserGameRolesByCookie` + +**参数：** + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| game_biz | str | 游戏标识符 | 若该值为空，将返回所有绑定游戏账号的信息 | + +**JSON返回：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码 | | +| message | str | 返回消息 | | +| data | obj | Cookie对应米游社账号绑定的游戏账号信息 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| list | arr | 游戏账号基本信息 | | + +`data`对象→`list`数组→对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| game_biz | str | 该游戏账号所属游戏的标识符 | | +| region | str | 该游戏账号所在服务器的名称 | | +| game_uid | str | 该游戏账号的UID | | +| nickname | str | 该游戏账号的昵称 | | +| level | num | 该游戏账号的等级 | | +| is_chosen | bool | 是否已收藏该游戏账号 | | +| region_name | str | 该游戏账号所在服务器的称呼 | | +| is_official | bool | 该游戏账号所在服务器是否为官方服务器 | | + +
+查看示例 + +```json +{ + "retcode": 0, + "message": "OK", + "data": { + "list": [ + { + "game_biz": "hk4e_cn", + "region": "cn_qd01", + "game_uid": "524923864", + "nickname": "༽墨ᐒ染ᐓ月༼", + "level": 22, + "is_chosen": false, + "region_name": "世界树", + "is_official": false + }, + ... + ] + } +} +``` +
+ +## 通过SToken获取绑定游戏账号的基本信息 + +**国服：** + +_请求方式：GET_ + +> _需要验证请求头_ +> +> `x-rpc-client_type`：`2` +> +> K2`salt` +> +> `DS1` + +> _需要验证Cookie_ +> +> SToken + +`https://api-takumi.miyoushe.com/binding/api/getUserGameRolesByStoken` + +**JSON返回：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码 | | +| message | str | 返回消息 | | +| data | obj | Cookie对应米游社账号绑定的游戏账号信息 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| list | arr | 游戏账号基本信息 | | + +`data`对象→`list`数组→对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| game_biz | str | 该游戏账号所属游戏的标识符 | | +| region | str | 该游戏账号所在服务器的名称 | | +| game_uid | str | 该游戏账号的UID | | +| nickname | str | 该游戏账号的昵称 | | +| level | num | 该游戏账号的等级 | | +| is_chosen | bool | 是否已收藏该游戏账号 | | +| region_name | str | 该游戏账号所在服务器的称呼 | | +| is_official | bool | 该游戏账号所在服务器是否为官方服务器 | | + +
+查看示例 + +```json +{ + "retcode": 0, + "message": "OK", + "data": { + "list": [ + { + "game_biz": "hk4e_cn", + "region": "cn_qd01", + "game_uid": "524923864", + "nickname": "༽墨ᐒ染ᐓ月༼", + "level": 22, + "is_chosen": false, + "region_name": "世界树", + "is_official": false + }, + ... + ] + } +} +``` +
+ ## 原神

获取玩家首页信息

diff --git a/hoyolab/user/info.md b/hoyolab/user/info.md index c664429..4e97564 100644 --- a/hoyolab/user/info.md +++ b/hoyolab/user/info.md @@ -324,6 +324,7 @@ _请求方式：GET_ _请求方式：GET_ 网页：`https://bbs-api.miyoushe.com/post/wapi/userPost` + 应用：`https://bbs-api.miyoushe.com/painter/api/user_instant/list` **参数：** diff --git a/other/id.md b/other/id.md index dad5944..0d3b171 100644 --- a/other/id.md +++ b/other/id.md @@ -17,12 +17,15 @@ - [文章类型](#文章类型) - [实体类型](#实体类型) - [启动器ID与Key](#启动器ID与key) +- [游戏标识符](#游戏标识符) - [原神](#原神) - [服务器名称](#genshin-server-region) - [角色ID](#genshin-characters) - [崩坏：星穹铁道](#崩坏星穹铁道) - [服务器名称](#star-rail-server-region) - [角色ID](#star-rail-characters) +- [崩坏3](#崩坏3) + - [服务器名称](#honkai-3-server-region) --- @@ -174,6 +177,16 @@ | 10 | gcStgarh | 原神 | 国际服 | | | 33 | 6KcVuOkbcqjJomjZ | 崩坏：星穹铁道 | 国服 | | +## 游戏标识符 + +一般被称为`game_biz`。 + +| 标识符 | 游戏 | 服务器 | 备注 | +| ----- | ---- | ----- | ---- | +| hk4e_cn | 原神 | 国服 | | +| hkrpg_cn | 崩坏：星穹铁道 | 国服 | | +| bh3_cn | 崩坏3 | 国服 | | + ## 原神

服务器名称

@@ -291,3 +304,10 @@ UIGF API收集了角色、物品、武器的ID，[此文档](genshin_impact/thir | 8002 | 开拓者 | | | 星穹列车 | | 1013 | 黑塔 | 智识 | 冰 | 空间站「黑塔」 | +## 崩坏3 + +

服务器名称

+ +| 名称 | 服务器 | 类别 | +| --- | ------ | ---- | +| pc01 | 全平台（桌面）服 | 国服 | \ No newline at end of file