PaiGramTeam/mihoyo-api-collect
3
0
Fork 0
mirror of https://github.com/PaiGramTeam/mihoyo-api-collect.git synced 2024-11-22 07:07:43 +00:00
Code Issues Packages Projects Releases Wiki Activity

- 【R】将不再更新的“原神第三方API”标记“已弃用”

Browse Source 
- 【F】修复“游戏启动器信息”文档中的大量错误
- 【A】为“游戏启动器信息”文档增加接口返回示例
- 【A】“ID对照表”中增加部分“米游社文章类型”
- 【P】将“ID对照表”中“启动器ID与Key”的项进行排序
This commit is contained in:
Kamisato-Ayaka-233 2023-08-23 15:56:05 +08:00
parent 698b69bc68
commit 27f42f42c6
6 changed files with 364 additions and 139 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@ -68,7 +68,7 @@
- [x] [绕过检测与鉴权](other/authentication.md) - [x] [绕过检测与鉴权](other/authentication.md)
- [ ] [错误码](other/error_code.md) - [ ] [错误码](other/error_code.md)
- [ ] [各种ID对照表](other/id.md) - [ ] [各种ID对照表](other/id.md)
- [ ] [启动器API](other/launcher.md) - [ ] [游戏启动器信息](other/launcher.md)
--- ---
### 米游社（HoYoLab，MiYouShe） ### 米游社（HoYoLab，MiYouShe）

4
genshin_impact/thirdparty/dictionary_of_item.md vendored
View File

@ -1,7 +1,7 @@
# 项目ID与名称的字典 # 项目ID与名称的字典
- [UIGF API](#uigf-api) - [UIGF API](#uigf-api)
- [Caughtwind API](#caughtwind-api) - [Caughtwind API](#caughtwind-api已弃用)
--- ---
@ -25,7 +25,7 @@ _请求方式：GET_
| --- | ---- | ---- | --- | | --- | ---- | ---- | --- |
| “项目名称” | str | 项目ID | | | “项目名称” | str | 项目ID | |
## Caughtwind API ## Caughtwind API（已弃用）
_请求方式：GET_ _请求方式：GET_

4
genshin_impact/thirdparty/historical_up_items.md vendored
View File

@ -1,10 +1,10 @@
# 历史祈愿UP池 # 历史祈愿UP池
- [Caughtwind API](#caughtwind-api) - [Caughtwind API](#caughtwind-api已弃用)
--- ---
## Caughtwind API ## Caughtwind API（已弃用）
_请求方式：GET_ _请求方式：GET_

28
hoyolab/article/article.md
View File

@ -227,7 +227,7 @@ _请求方式：GET_
| forum_id | num | 所属论坛的ID | | | forum_id | num | 所属论坛的ID | |
| forum_name | str | 所属论坛的名称 | | | forum_name | str | 所属论坛的名称 | |
| banner | str | 文章封面链接 | | | banner | str | 文章封面链接 | |
| view_type | num | 文章呈现类型<br />1 内容以文字类文章为主<br />2 内容以图片类文章为主<br />5 内容以视频类文章为主 | 文字类文章示例：[【V3.8攻略·七圣召唤】万叶、烟绯、坎蒂丝新卡一图流解读！-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41059886)<br />图片类文章示例：[「可莉」头像 一起来玩吧~~~~【观测枢】-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41214610)<br />视频类文章示例：[【欢愉一夏主题视频】3.8游园会BGM神还原~(观测枢)-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41175339) | | view_type | num | 文章呈现类型<br>1 内容以文字文章为主<br />2 内容以图片文章为主<br>5 内容以视频文章为主 | 文字类文章示例：[【V3.8攻略·七圣召唤】万叶、烟绯、坎蒂丝新卡一图流解读！-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41059886)<br>图片类文章示例：[「可莉」头像 一起来玩吧~~~~【观测枢】-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41214610)<br>视频类文章示例：[【欢愉一夏主题视频】3.8游园会BGM神还原~(观测枢)-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41175339) |
<details> <details>
@ -683,8 +683,8 @@ _请求方式：GET_
`data`对象→`post`对象： `data`对象→`post`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------------ | ----------- | -------------------------- | ----------------------------------- | | --- | ---- | ---- | ---- |
| post | obj | 文章内容 | | | post | obj | 文章内容 | |
| forum | obj | 板块信息 | | | forum | obj | 板块信息 | |
| topics | obj | 文章的标签 | | | topics | obj | 文章的标签 | |
@ -802,14 +802,14 @@ _请求方式：GET_
`data`对象→`post`对象→`collection`对象： `data`对象→`post`对象→`collection`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | ------------------------------ | ---- | | ---- | --- | ---- | --- |
| prev_post_id | str | 该集合下的上一篇文章的文章id | | | prev_post_id | str | 该集合下的上一篇文章的文章id | |
| next_post_id | str | 该集合下的下一篇文章的文章id | | | next_post_id | str | 该集合下的下一篇文章的文章id | |
| collection_id | str | 集合id | | | collection_id | str | 集合id | |
| cur | num | 当前文章在该集合下的指针 | | | cur | num | 当前文章在该集合下的指针 | |
| total | num | 该集合下的所有文章数量 | | | total | num | 该集合下的所有文章数量 | |
| collection_title | str | 集合标题 | | | collection_title | str | 集合标题 | |
| prev_post_game_id | num | 该集合下的上一篇文章的游戏id | | | prev_post_game_id | num | 该集合下的上一篇文章的游戏id | |
| next_post_game_id | num | 该集合下的下一篇文章的游戏id | | | next_post_game_id | num | 该集合下的下一篇文章的游戏id | |
| prev_post_view_type | num | 该集合下的上一篇文章的呈现类型 | | | prev_post_view_type | num | 该集合下的上一篇文章的呈现类型 | |
@ -1198,18 +1198,14 @@ _请求方式：GET_
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------------------------------------------------------ | ---- | | ----- | ---- | ------------------------------------------------------------ | ---- |
| type | num | 认证类别<br />1 社区或游戏官方<br />2 已认证的创作者<br />0 未认证的用户 | | | type | num | 认证类别<br />1 社区或游戏官方<br />2 已认证的创作者<br />0 未认证的用户 | |
| label | str | 认证具体信息 | | | label | str | 认证具体信息 | |
`data`对象→`list`数组→`user`对象→`level_exp`对象 或 `data`对象→`list`数组→对象→`sub_replies`对象→`user`对象→`level_exp`对象： `data`对象→`list`数组→`user`对象→`level_exp`对象 或 `data`对象→`list`数组→对象→`sub_replies`对象→`user`对象→`level_exp`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | ---- | | ---- | --- | --- | ----- |
| level | num | 用户的社区等级 | | | level | num | 用户的社区等级 | |
| exp | num | 用户的社区经验 | | | exp | num | 用户的社区经验 | |
<details> <details>
<summary>查看示例</summary> <summary>查看示例</summary>

30
other/id.md
View File

@ -13,7 +13,8 @@
- [绝区零](#forum-zenless-zone-zero) - [绝区零](#forum-zenless-zone-zero)
- [子分区](#forum-sub-area) - [子分区](#forum-sub-area)
- [视频分区](#forum-video-area) - [视频分区](#forum-video-area)
- [启动器ID以及key](#启动器ID以及key) - [文章类型](#文章类型)
- [启动器ID与Key](#启动器ID与key)
- [原神](#原神) - [原神](#原神)
- [服务器名称](#genshin-server-region) - [服务器名称](#genshin-server-region)
- [角色ID](#genshin-characters) - [角色ID](#genshin-characters)
@ -35,14 +36,14 @@
| 6 | 崩坏：星穹铁道 | | | 6 | 崩坏：星穹铁道 | |
| 8 | 绝区零 | | | 8 | 绝区零 | |
## 启动器ID以及key ## 启动器ID与Key
| ID | 启动器 | key | 备注 | | ID | Key | 游戏 | 服务器 | 备注 |
| ------ | ---- | --- | --- | | -- | --- | ---- | ----- | ---- |
| 33 | 崩坏：星穹铁道（官服） | 6KcVuOkbcqjJomjZ | | | 17 | KAtdSsoQ | 原神 | 哔哩哔哩服 | |
| 18 | 原神(官服) | eYd89JmJ | | | 18 | eYd89JmJ | 原神 | 官服 | |
| 17 | 原神(B服) | KAtdSsoQ | | | 10 | gcStgarh | 原神 | 国际服 | |
| 10 | 原神(国际服) | gcStgarh | | | 33 | 6KcVuOkbcqjJomjZ | 崩坏：星穹铁道 | 国服 | |
## 论坛ID ## 论坛ID
@ -146,6 +147,13 @@
| 14 | 录屏·演示 | | | 14 | 录屏·演示 | |
| 15 | 生活记录 | | | 15 | 生活记录 | |
## 文章类型
| 名称 | 类型 | 备注 |
| --- | ---- | ---- |
| POST_TYPE_INFO | 以文本为主的文章 | |
| POST_TYPE_ANNOUNCE | 公告文章 | |
| POST_TYPE_ACTIVITY | 活动公告文章 | |
## 原神 ## 原神
@ -162,9 +170,9 @@
<h3 id="genshin-characters">角色ID</h3> <h3 id="genshin-characters">角色ID</h3>
UIGF收集了角色、物品、武器的ID，[此处](https://uigf.org/zh/API.html)即为他们的API使用指南。 UIGF API收集了角色、物品、武器的ID，[此文档](genshin_impact/thirdparty/dictionary_of_item.md)列出了一些API；[此处](https://uigf.org/zh/API.html)即为UIGF API的使用指南。
| ID | 角色 | 元素 | 国家 | <!-- | ID | 角色 | 元素 | 国家 |
| -- | ---- | --- | ---- | | -- | ---- | --- | ---- |
| 10000002 | 神里绫华 | 冰 | 稻妻 | | 10000002 | 神里绫华 | 冰 | 稻妻 |
| 10000003 | 琴 | 风 | 蒙德 | | 10000003 | 琴 | 风 | 蒙德 |
@ -229,7 +237,7 @@ UIGF收集了角色、物品、武器的ID，[此处](https://uigf.org/zh/API.ht
| 10000075 | 流浪者 | 风 | | | 10000075 | 流浪者 | 风 | |
| 10000076 | 珐露珊 | 风 | 须弥 | | 10000076 | 珐露珊 | 风 | 须弥 |
| 10000077 | 瑶瑶 | 草 | 璃月 | | 10000077 | 瑶瑶 | 草 | 璃月 |
| 10000078 | 艾尔海森 | 草 | 须弥 | | 10000078 | 艾尔海森 | 草 | 须弥 | -->
## 崩坏：星穹铁道 ## 崩坏：星穹铁道

435
other/launcher.md
View File

@ -1,117 +1,224 @@
# 启动器api # 游戏启动器信息
### 获取显示内容
原神国服：`https://sdk-static.mihoyo.com/hk4e_cn/mdk/launcher/api/content` - [获取推荐内容](#获取推荐内容)
<br>
原神国际服：`https://hk4e-launcher-static.hoyoverse.com/hk4e_global/mdk/launcher/api/content` ---
<br>
崩坏:星穹铁道国服：`https://api-launcher.mihoyo.com/hkrpg_cn/mdk/launcher/api/content` ## 获取推荐内容
_请求方式：GET_
《原神》国服：`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 | | | key | str | 启动器Key | |
| language | str | 语言 | 默认zh-cn |
| filter_adv | bool | 是否为简略信息 | 默认fasle |
| launcher_id | num | 启动器ID | | | launcher_id | num | 启动器ID | |
| language | str | 返回文本语言的国家代码 | |
| filter_adv | bool | 是否不获取背景图信息 | 留空则返回所有信息，即`false` |
**JSON返回：** **JSON返回：**
根对象： 根对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| retcode | num | 返回码 | | | retcode | num | 返回码<br>-204 请求参数`launcher_id`的值无效<br>-205 请求参数`key`的值无效 | |
| message | str | 返回消息 | | | message | str | 返回消息 | |
| data | obj | 返回数据 | | | data | obj | 推荐信息 | 若请求参数中的`language`为不支持的语言，则所有数据均为空与空数组 |
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| adv | obj | 玩家基础信息 | | | adv | obj | 背景图片信息 | |
| banner | list | 游戏资讯 | | | banner | arr | 游戏资讯 | |
| icon | list | 启动器侧边栏图标 | | | icon | arr | 启动器侧边栏图标及其信息 | |
| post | list | 好像也是游戏资讯 | | | post | arr | 最近的官方资讯文章信息 | |
| qq | obj | 官方QQ群 | | | qq | obj | 官方QQ群信息 | |
| more | obj | 未知 | | | more | obj | 待调查 | |
| links | obj | faq | | | links | obj | 常见问题页面的URL | |
`data`对象→`adv`对象： `data`对象→`adv`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| background | str | 背景图URL | | | background | str | 背景图片的URL | 文件名中“_”字符前为该图片的MD5校验码 |
| icon | str | 版本热点图片URL | | | icon | str | 版本热点按钮图片的URL | |
| url | str | 版本主题页 | | | url | str | 版本专题内容页面的URL | |
| version | str | 背景图版本 | 背景图变动时会变大 | | version | str | 背景图版本 | |
| bg_checksum | str | 背景图哈希值 | 可能是md5 | | bg_checksum | str | 待调查 | 疑似为背景图片的校验码，但经过比对后，发现其与MD5和任何哈希散列算法通过图片内容生成的值无法匹配 |
`data`对象→`banner`数组→对象： `data`对象→`banner`数组→对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| banner_id | str | 未知 | | | banner_id | str | 待调查 | |
| name | null | 未知 | | | name | str | 待调查 | 似乎总是为空字符串 |
| img | str | 文章头图 | | | img | str | 文章封面图片的URL | |
| url | str | 文章链接 | | | url | str | 文章页面的URL | |
| order | str | 可能是排序 | 1-10之间 | | order | str | 文章滚动的排序值 | 范围为1-10 |
`data`对象→`icon`数组→对象： `data`对象→`icon`数组→对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| icon_id | str | 未知 | | | icon_id | str | 待调查 | |
| img | str | 图标 | | | img | str | 图标URL | |
| url | str | 链接 | | | url | str | 该图标将会跳转至的URL | |
| title | str | 标题 | | | title | str | 二维码下方按钮的文本 | |
| tittle | str | 标题 | | | tittle | str | 与`title`字段的内容相同 | |
| qr_img | str | 二维码图片 | | | qr_img | str | 二维码图片URL | |
| qr_desc | str | 二维码描述 | | | qr_desc | str | 二维码下方描述的文本 | |
| img_hover | str | 鼠标悬停图片 | | | img_hover | str | 鼠标悬停时显示图标的URL | |
| other_links | arr | 未知 | 一般为空 | | other_links | arr | 待调查 | 似乎总是为空数组 |
| links | arr | 链接列表 | 可能为空 | | links | arr | 二维码下方按钮的跳转URL | |
| icon_link | str | 未知 | 一般为空 | | icon_link | str | 待调查 | 总是为空字符串 |
`data`对象→`icon`数组→对象→`links`数组→对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| title | str | 按钮内文本 | |
| url | str | 按钮将跳转的URL | |
`data`对象→`post`数组→对象： `data`对象→`post`数组→对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| post_id | str | 未知 | |
| type | str | 未知 | |
| title | str | 标题 | |
| show_time | str | 时间 | |
| url | str | 链接 | |
| tittle | str | 标题 | |
| order | str | 排序 | 1-12 |
`data`对象→`qq`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| post_id | str | 待调查 | |
| type | str | 米游社文章类型 | |
| title | str | 文章标题 | |
| show_time | str | 文章发布的时间 | 格式为“月/日” |
| url | str | 文章链接 | |
| tittle | str | 与`title`字段的内容相同 | |
| order | str | 列表排序值 | 范围为1-12 |
`data`对象→`qq`数组→对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| qq_id | str | 待调查 | |
| number | str | QQ群号 | | | number | str | QQ群号 | |
| name | str | 群名称 | | | name | str | QQ群名称 | |
| code | str | 群链接 | | | code | str | QQ群URL | URL经过Unicode转义 |
| qq_id | str | 未知 | |
`data`对象→`links`对象： `data`对象→`links`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| faq | str | faq链接 | | | faq | str | 常见问题页面的URL | |
| version | str | 未知 | 一般为1 | | version | str | 待调查 | 总是为1 |
<details>
<summary>查看示例</summary>
```json
{
"retcode": 0,
"message": "OK",
"data": {
"adv": {
"background": "https://launcher-webstatic.mihoyo.com/launcher-public/2023/08/14/7f92b296633974293b1cc9ced73952f9_2267874619055857570.png",
"icon": "https://launcher-webstatic.mihoyo.com/launcher-public/2023/08/14/5d0d835da94aaf76f6c41a0a51cd51af_3635147868632833439.png",
"url": "https://webstatic.mihoyo.com/ys/event/e20210601blue_post/vert.html?page_sn=d5dda66067224184\\u0026bbs_presentation_style=fullscreen\\u0026utm_source=game\\u0026utm_medium=ys\\u0026utm_campaign=bt",
"version": "308",
"bg_checksum": "8b375f844058d43255c33e2e4e71483a"
},
"banner": [
{
"banner_id": "64df45b948f1ddd6ee9b3fd2",
"name": "",
"img": "https://launcher-webstatic.mihoyo.com/launcher-public/2023/08/18/7c65cb9f5367e6b06ae1051c2c16f3a2_7403794543422733768.jpg",
"url": "https://www.miyoushe.com/ys/article/42537480",
"order": "7"
},
...
],
"icon": [
{
"icon_id": "5f5b7ca3b10d9a70d0e47d86",
"img": "https://webstatic.mihoyo.com/upload/operation_location/2020/09/11/41dbaf011ef6fd782450e6b59255d410_2396120149109972020.png",
"tittle": "加入QQ群",
"url": "https://ys.mihoyo.com/launcher/18/zh-cn/qq?api_url=https%3A%2F%2Fapi-sdk.mihoyo.com%2Fhk4e_cn\\u0026prev=false",
"qr_img": "",
"qr_desc": "",
"img_hover": "https://webstatic.mihoyo.com/upload/operation_location/2020/09/11/d9b6a36596d49e8c2b262f3db8b271d9_6971507594010738352.png",
"other_links": [],
"title": "加入QQ群",
"icon_link": "https://ys.mihoyo.com/launcher/18/zh-cn/qq?api_url=https%3A%2F%2Fapi-sdk.mihoyo.com%2Fhk4e_cn\\u0026prev=false",
"links": [
{
"title": "加入QQ群",
"url": "https://ys.mihoyo.com/launcher/18/zh-cn/qq?api_url=https%3A%2F%2Fapi-sdk.mihoyo.com%2Fhk4e_cn\\u0026prev=false"
},
...
]
},
...
],
"post": [
{
"post_id": "64e587f248f1ddd6ee9b3fe9",
"type": "POST_TYPE_INFO",
"tittle": "《原神》枫丹实机画面展示片｜Gamescom 2023",
"url": "https://www.miyoushe.com/ys/article/42711525",
"show_time": "08/23",
"order": "11",
"title": "《原神》枫丹实机画面展示片｜Gamescom 2023"
},
...
],
"qq": [
{
"qq_id": "5fe2a761b15384c3e4621420",
"name": "原神官方玩家群11",
"number": "512047400",
"code": "https://jq.qq.com/?_wv=1027\\u0026k=4dhAg811"
},
...
],
"more": {
"activity_link": "",
"announce_link": "",
"info_link": "",
"news_link": "",
"trends_link": "",
"supply_link": "",
"tools_link": ""
},
"links": {
"faq": "https://bbs.mihoyo.com/ys/article/4004423",
"version": "1"
}
}
}
```
</details>
### 获取游戏下载链接 ### 获取游戏下载链接
原神国服：`https://sdk-static.mihoyo.com/hk4e_cn/mdk/launcher/api/resource` _请求方式：GET_
<br>
原神国际服：`https://hk4e-launcher-static.hoyoverse.com/hk4e_global/mdk/launcher/api/resource` 《原神》国服：`https://sdk-static.mihoyo.com/hk4e_cn/mdk/launcher/api/resource`
崩坏：星穹铁道国服：`https://api-launcher.mihoyo.com/hkrpg_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 | | | key | str | 启动器Key | |
| launcher_id | num | 启动器id | | | launcher_id | num | 启动器ID | |
**JSON返回：** **JSON返回：**
@ -121,90 +228,204 @@
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| retcode | num | 返回码 | | | retcode | num | 返回码 | |
| message | str | 返回消息 | | | message | str | 返回消息 | |
| data | obj | 玩家信息 | | | data | obj | 资源信息 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| game | obj | 游戏主要资源信息 | |
| plugin | obj | 游戏运行库信息 | |
| web_url | str | 启动器下载页面URL | |
| force_update | | 待调查 | |
| pre_download_game | | 待调查 |
| sdk | | 待调查 |
| deprecated_packages | arr | 已弃用游戏资源文件的文件名与MD5值 | |
| deprecated_files | arr | 已弃用游戏文件的文件名与MD5值 | |
`data`对象→`game`对象： `data`对象→`game`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| latest | obj | 最新版本 | | | latest | obj | 最新版本文件信息 | |
| diffs | obj | 增量包 | | | diffs | arr | 一些旧版本至当前版本的增量文件信息 | |
| web_url | str | 启动器首页？ | |
| force_update | null | 未知 | |
| pre_download_game | null | 未知 |
| deprecated_packages | obj | 压缩包MD5 | |
| sdk | null | 未知 |
| deprecated_files | obj | 压缩包内部分文件MD5 | |
`data`对象→`game`对象→`latest`对象： `data`对象→`game`对象→`latest`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| version | str | 版本号 | | | version | str | 最新游戏版本 | |
| name | str | 版本名称 | 一般为空 | | name | str | 文件名称 | 总是为空字符串 |
| path | str | 下载链接 | | | path | str | 空字符串 | 根据`diffs`数组→对象→`path`字段的规律，本应为文件URL，但是被`segments`字段取代 |
| size | str | 解压后文件大小 | 单位为B | | size | str | 文件解压后的大小 | |
| md5 | str | 文件md5 | | | md5 | str | 该文件的MD5值 | |
| voice_packs | obj | 语音包列表 | 崩坏：星穹铁道为空 | | voice_packs | arr | 所有语音包信息 | 《崩坏：星穹铁道》为空数组 |
| decompressed_path | str | 未知 | | | decompressed_path | str | 待调查 | |
| segments | obj | 分卷压缩包列表 | 崩坏：星穹铁道为空 | | segments | arr | 游戏资源压缩文件各分卷的信息 | 《崩坏：星穹铁道》为空数组 |
| package_size | 压缩包体积 | 单位为B | | package_size | str | 压缩包文件大小 | |
| entry | str | 游戏入口 | | | entry | str | 游戏启动程序的文件名 | |
`data`对象→`game`对象→`latest`对象→`voice_packs`数组→对象： `data`对象→`game`对象→`latest`对象→`voice_packs`数组→对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| language | str | 语言 | | | language | str | 语音资源对应的语言代码 | |
| path | str | 下载链接 | | | path | str | 该资源文件的URL | |
| name | str | 语音包名称 | 一般为空 | | name | str | 语音包文件名称 | 总是为空字符串 |
| size | str | 解压后文件大小 | 单位为B | | size | str | 文件解压后的大小 | |
| package_size | 压缩包体积 | 单位为B | | package_size | str | 压缩包文件大小 | |
| md5 | str | 文件md5 | | | md5 | str | 文件的MD5值 | |
`data`对象→`game`对象→`latest`对象→`segments`数组→对象： `data`对象→`game`对象→`latest`对象→`segments`数组→对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| path | str | 下载链接 | | | path | str | 该资源文件的URL | |
| md5 | str | 文件md5 | | | md5 | str | 文件的MD5值 | |
| package_size | 压缩包体积 | 单位为B | | package_size | str | 压缩包文件大小 | |
`data`对象→`game`对象→`diffs`数组→对象： `data`对象→`game`对象→`diffs`数组→对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| name | str | 文件名 | | | name | str | 文件名 | |
| version | str | 旧文件版本号 | | | version | str | 该增量包修补的旧版本 | |
| path | str | 下载链接 | | | path | str | 该增量包的URL | |
| size | str | 解压后文件大小 | 单位为B | | size | str | 文件解压后的大小 | |
| md5 | str | 文件md5 | | | md5 | str | 文件的MD5值 | |
| package_size | 压缩包体积 | 单位为B | | package_size | str | 压缩包文件大小 | |
| is_recommended_update | bool | 未知 | | | is_recommended_update | bool | 待调查 | |
| voice_packs | obj | 语音包列表 | 崩坏：星穹铁道为空 | | voice_packs | obj | 所有语音增量包信息 | 《崩坏：星穹铁道》为空 |
`data`对象→`game`对象→`diffs`数组→`voice_packs`数组→对象： `data`对象→`game`对象→`diffs`数组→`voice_packs`数组→对象：
与`data`对象→`game`对象→`deprecated_packages`数组→对象中的结构相同 与`data`对象→`game`对象→`latest`对象→`voice_packs`数组→对象的结构相同
`data`对象→`plugin`对象： `data`对象→`plugin`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| plugins | obj | 插件列表? | | | plugins | arr | 运行库信息 | |
| version | str | 版本号? | | | version | str | 运行库版本 | |
`data`对象→`plugin`对象→`plugins`数组→对象： `data`对象→`plugin`对象→`plugins`数组→对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| name | str | 插件名称? | | | name | str | 运行库文件名 | |
| path | str | 下载链接 | | | path | str | 运行库文件URL | |
| md5 | str | 文件md5 | | | md5 | str | 文件的MD5值 | |
| version | str | 文件版本号 | | | version | str | 该文件的版本 | 总是为空字符串 |
| size | str | 文件大小 | 单位为B | | size | str | 文件大小 | |
| entry | str | 入口文件 | 可能为空 | | entry | str | 运行库安装程序的文件名 | 可能为空字符串 |
`data`对象→`game`对象→`deprecated_packages`数组→对象： `data`对象→`game`对象→`deprecated_packages`数组→对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- | | ---- | ---- | ---- | ---- |
| name | str | 文件名 | | | name | str | 文件名 | |
| md5 | str | 文件md5 | | | md5 | str | 文件的MD5值 | |
`data`对象→`game`对象→`deprecated_files`数组→对象： `data`对象→`game`对象→`deprecated_files`数组→对象：
<br>
同：`data`对象→`game`对象→`deprecated_packages`数组→对象： 与`data`对象→`game`对象→`deprecated_packages`数组→对象的结构相同
<details>
<summary>查看示例</summary>
```json
{
"retcode": 0,
"message": "OK",
"data": {
"game": {
"latest": {
"name": "",
"version": "4.0.0",
"path": "",
"size": "120599654462",
"md5": "3c70931b5ae61d89abe0403dff2365ef",
"entry": "YuanShen.exe",
"voice_packs": [
{
"language": "zh-cn",
"name": "",
"path": "https://autopatchcn.yuanshen.com/client_app/download/pc_zip/20230804185703_R1La3H9xIH1hBiHJ/Audio_Chinese_4.0.0.zip",
"size": "22459851756",
"md5": "690b7cf26d12ffdad839027f2ed75914",
"package_size": "11224682998"
},
...
],
"decompressed_path": "https://autopatchcn.yuanshen.com/client_app/download/pc_zip/20230804185703_R1La3H9xIH1hBiHJ/ScatteredFiles",
"segments": [
{
"path": "https://autopatchcn.yuanshen.com/client_app/download/pc_zip/20230804185703_R1La3H9xIH1hBiHJ/YuanShen_4.0.0.zip.001",
"md5": "7da1c2721272ffa2d0df2a14ca9b7885",
"package_size": "10737418240"
},
...
],
"package_size": "60294584351"
},
"diffs": [
{
"name": "game_3.8.0_4.0.0_hdiff_h2FAbmpdS1P3OQ6r.zip",
"version": "3.8.0",
"path": "https://autopatchcn.yuanshen.com/client_app/update/hk4e_cn/18/game_3.8.0_4.0.0_hdiff_h2FAbmpdS1P3OQ6r.zip",
"size": "67793295222",
"md5": "42BA351D7B2ED6058E3BC19AC88EF639",
"is_recommended_update": false,
"voice_packs": [
{
"language": "zh-cn",
"name": "zh-cn_3.8.0_4.0.0_hdiff_q7JUo5yfuLOYZVFE.zip",
"path": "https://autopatchcn.yuanshen.com/client_app/update/hk4e_cn/18/zh-cn_3.8.0_4.0.0_hdiff_q7JUo5yfuLOYZVFE.zip",
"size": "1436148319",
"md5": "30438FBF20AE9C7706D78C76DBBA38AF",
"package_size": "658001593"
},
...
],
"package_size": "33699060276"
},
...
]
},
"plugin": {
"plugins": [
{
"name": "DXSETUP.zip",
"version": "",
"path": "https://autopatchcn.yuanshen.com/client_app/plugins/DXSETUP.zip",
"size": "100647892",
"md5": "CA2AC3835D7D7DA6CB8624FEFB177083",
"entry": "",
"package_size": "0"
},
...
],
"version": "1"
},
"web_url": "https://ys.mihoyo.com/launcher",
"force_update": null,
"pre_download_game": null,
"deprecated_packages": [
{
"name": "YuanShen_4.0.0.zip.001",
"md5": "7da1c2721272ffa2d0df2a14ca9b7885"
},
...
],
"sdk": null,
"deprecated_files": [
{
"name": "YuanShen_Data/Plugins/PCGameSDK.dll",
"md5": ""
},
...
]
}
}
```
</details>