diff --git a/README.md b/README.md index bfdf0d4..d27b3c9 100644 --- a/README.md +++ b/README.md @@ -68,7 +68,7 @@ - [x] [绕过检测与鉴权](other/authentication.md) - [ ] [错误码](other/error_code.md) - [ ] [各种ID对照表](other/id.md) - +- [ ] [启动器API](other/launcher.md) --- ### 米游社(HoYoLab,MiYouShe) @@ -91,6 +91,7 @@ - [x] [用户Token](hoyolab/user/token.md) - [ ] [用户游戏信息](hoyolab/user/game_account_info.md) + --- ### 《原神(Genshin Impact,Genshin,hk4e)》 @@ -131,7 +132,6 @@ 《崩坏3》游戏内的API。 --> - --- ## 贡献 diff --git a/other/id.md b/other/id.md index 843d6eb..7afd2bd 100644 --- a/other/id.md +++ b/other/id.md @@ -1,4 +1,5 @@ + # ID对照表 - [游戏ID](#游戏id) @@ -12,6 +13,7 @@ - [绝区零](#forum-zenless-zone-zero) - [子分区](#forum-sub-area) - [视频分区](#forum-video-area) +- [启动器ID以及key](#启动器ID以及key) - [原神](#原神) - [服务器名称](#genshin-server-region) - [角色ID](#genshin-characters) @@ -33,6 +35,14 @@ | 6 | 崩坏:星穹铁道 | | | 8 | 绝区零 | | +## 启动器ID以及key + +| ID | 启动器 | key | 备注 | +| ------ | ---- | --- | --- | +| 33 | 崩坏:星穹铁道(官服) | 6KcVuOkbcqjJomjZ | | +| 18 | 原神(官服) | eYd89JmJ | | +| 17 | 原神(B服) | KAtdSsoQ | | +| 10 | 原神(国际服) | gcStgarh | | ## 论坛ID diff --git a/other/launcher.md b/other/launcher.md new file mode 100644 index 0000000..b6388ff --- /dev/null +++ b/other/launcher.md @@ -0,0 +1,210 @@ +# 启动器api +### 获取显示内容 +原神国服:`https://sdk-static.mihoyo.com/hk4e_cn/mdk/launcher/api/content` +
+原神国际服:`https://hk4e-launcher-static.hoyoverse.com/hk4e_global/mdk/launcher/api/content` +
+崩坏:星穹铁道国服:`https://api-launcher.mihoyo.com/hkrpg_cn/mdk/launcher/api/content` + +**参数:** + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| key | str | 启动器Key | | +| language | str | 语言 | 默认zh-cn | +| filter_adv | bool | 是否为简略信息 | 默认fasle | +| launcher_id | num | 启动器ID | | + +**JSON返回:** +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码 | | +| message | str | 返回消息 | | +| data | obj | 返回数据 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| adv | obj | 玩家基础信息 | | +| banner | list | 游戏资讯 | | +| icon | list | 启动器侧边栏图标 | | +| post | list | 好像也是游戏资讯 | | +| qq | obj | 官方QQ群 | | +| more | obj | 未知 | | +| links | obj | faq | | + +`data`对象→`adv`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| background | str | 背景图URL | | +| icon | str | 版本热点图片URL | | +| url | str | 版本主题页 | | +| version | str | 背景图版本 | 背景图变动时会变大 | +| bg_checksum | str | 背景图哈希值 | 可能是md5 | + +`data`对象→`banner`数组→对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| banner_id | str | 未知 | | +| name | null | 未知 | | +| img | str | 文章头图 | | +| url | str | 文章链接 | | +| order | str | 可能是排序 | 1-10之间 | + +`data`对象→`icon`数组→对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| icon_id | str | 未知 | | +| img | str | 图标 | | +| url | str | 链接 | | +| title | str | 标题 | | +| tittle | str | 标题 | | +| qr_img | str | 二维码图片 | | +| qr_desc | str | 二维码描述 | | +| img_hover | str | 鼠标悬停图片 | | +| other_links | arr | 未知 | 一般为空 | +| links | arr | 链接列表 | 可能为空 | +| icon_link | str | 未知 | 一般为空 | + +`data`对象→`post`数组→对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| post_id | str | 未知 | | +| type | str | 未知 | | +| title | str | 标题 | | +| show_time | str | 时间 | | +| url | str | 链接 | | +| tittle | str | 标题 | | +| order | str | 排序 | 1-12 | + +`data`对象→`qq`对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| number | str | QQ群号 | | +| name | str | 群名称 | | +| code | str | 群链接 | | +| qq_id | str | 未知 | | + +`data`对象→`links`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| faq | str | faq链接 | | +| version | str | 未知 | 一般为1 | + +### 获取游戏下载链接 + +原神国服:`https://sdk-static.mihoyo.com/hk4e_cn/mdk/launcher/api/resource` +
+原神国际服:`https://hk4e-launcher-static.hoyoverse.com/hk4e_global/mdk/launcher/api/resource` +崩坏:星穹铁道国服:`https://api-launcher.mihoyo.com/hkrpg_cn/mdk/launcher/api/resource` + + +**参数:** + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| key | str | 启动器key | | +| launcher_id | num | 启动器id | | + +**JSON返回:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| retcode | num | 返回码 | | +| message | str | 返回消息 | | +| data | obj | 玩家信息 | | + +`data`对象→`game`对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| latest | obj | 最新版本 | | +| diffs | obj | 增量包 | | +| web_url | str | 启动器首页? | | +| force_update | null | 未知 | | +| pre_download_game | null | 未知 | +| deprecated_packages | obj | 压缩包MD5 | | +| sdk | null | 未知 | +| deprecated_files | obj | 压缩包内部分文件MD5 | | + +`data`对象→`game`对象→`latest`对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| version | str | 版本号 | | +| name | str | 版本名称 | 一般为空 | +| path | str | 下载链接 | | +| size | str | 解压后文件大小 | 单位为B | +| md5 | str | 文件md5 | | +| voice_packs | obj | 语音包列表 | 崩坏:星穹铁道为空 | +| decompressed_path | str | 未知 | | +| segments | obj | 分卷压缩包列表 | 崩坏:星穹铁道为空 | +| package_size | 压缩包体积 | 单位为B | +| entry | str | 游戏入口 | | + +`data`对象→`game`对象→`latest`对象→`voice_packs`数组→对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| language | str | 语言 | | +| path | str | 下载链接 | | +| name | str | 语音包名称 | 一般为空 | +| size | str | 解压后文件大小 | 单位为B | +| package_size | 压缩包体积 | 单位为B | +| md5 | str | 文件md5 | | + +`data`对象→`game`对象→`latest`对象→`segments`数组→对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| path | str | 下载链接 | | +| md5 | str | 文件md5 | | +| package_size | 压缩包体积 | 单位为B | + +`data`对象→`game`对象→`diffs`数组→对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| name | str | 文件名 | | +| version | str | 旧文件版本号 | | +| path | str | 下载链接 | | +| size | str | 解压后文件大小 | 单位为B | +| md5 | str | 文件md5 | | +| package_size | 压缩包体积 | 单位为B | +| is_recommended_update | bool | 未知 | | +| voice_packs | obj | 语音包列表 | 崩坏:星穹铁道为空 | + +`data`对象→`game`对象→`diffs`数组→`voice_packs`数组→对象: + +与`data`对象→`game`对象→`deprecated_packages`数组→对象中的结构相同 + +`data`对象→`plugin`对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| plugins | obj | 插件列表? | | +| version | str | 版本号? | | + +`data`对象→`plugin`对象→`plugins`数组→对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| name | str | 插件名称? | | +| path | str | 下载链接 | | +| md5 | str | 文件md5 | | +| version | str | 文件版本号 | | +| size | str | 文件大小 | 单位为B | +| entry | str | 入口文件 | 可能为空 | + +`data`对象→`game`对象→`deprecated_packages`数组→对象: +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| name | str | 文件名 | | +| md5 | str | 文件md5 | | + +`data`对象→`game`对象→`deprecated_files`数组→对象: +
+同:`data`对象→`game`对象→`deprecated_packages`数组→对象: