From 27f42f42c641c4f035af5e94c8e10b35cb53402f Mon Sep 17 00:00:00 2001
From: Kamisato-Ayaka-233 <2627706725@qq.com>
Date: Wed, 23 Aug 2023 15:56:05 +0800
Subject: [PATCH] =?UTF-8?q?-=20=E3=80=90R=E3=80=91=E5=B0=86=E4=B8=8D?=
=?UTF-8?q?=E5=86=8D=E6=9B=B4=E6=96=B0=E7=9A=84=E2=80=9C=E5=8E=9F=E7=A5=9E?=
=?UTF-8?q?=E7=AC=AC=E4=B8=89=E6=96=B9API=E2=80=9D=E6=A0=87=E8=AE=B0?=
=?UTF-8?q?=E2=80=9C=E5=B7=B2=E5=BC=83=E7=94=A8=E2=80=9D=20-=20=E3=80=90F?=
=?UTF-8?q?=E3=80=91=E4=BF=AE=E5=A4=8D=E2=80=9C=E6=B8=B8=E6=88=8F=E5=90=AF?=
=?UTF-8?q?=E5=8A=A8=E5=99=A8=E4=BF=A1=E6=81=AF=E2=80=9D=E6=96=87=E6=A1=A3?=
=?UTF-8?q?=E4=B8=AD=E7=9A=84=E5=A4=A7=E9=87=8F=E9=94=99=E8=AF=AF=20-=20?=
=?UTF-8?q?=E3=80=90A=E3=80=91=E4=B8=BA=E2=80=9C=E6=B8=B8=E6=88=8F?=
=?UTF-8?q?=E5=90=AF=E5=8A=A8=E5=99=A8=E4=BF=A1=E6=81=AF=E2=80=9D=E6=96=87?=
=?UTF-8?q?=E6=A1=A3=E5=A2=9E=E5=8A=A0=E6=8E=A5=E5=8F=A3=E8=BF=94=E5=9B=9E?=
=?UTF-8?q?=E7=A4=BA=E4=BE=8B=20-=20=E3=80=90A=E3=80=91=E2=80=9CID?=
=?UTF-8?q?=E5=AF=B9=E7=85=A7=E8=A1=A8=E2=80=9D=E4=B8=AD=E5=A2=9E=E5=8A=A0?=
=?UTF-8?q?=E9=83=A8=E5=88=86=E2=80=9C=E7=B1=B3=E6=B8=B8=E7=A4=BE=E6=96=87?=
=?UTF-8?q?=E7=AB=A0=E7=B1=BB=E5=9E=8B=E2=80=9D=20-=20=E3=80=90P=E3=80=91?=
=?UTF-8?q?=E5=B0=86=E2=80=9CID=E5=AF=B9=E7=85=A7=E8=A1=A8=E2=80=9D?=
=?UTF-8?q?=E4=B8=AD=E2=80=9C=E5=90=AF=E5=8A=A8=E5=99=A8ID=E4=B8=8EKey?=
=?UTF-8?q?=E2=80=9D=E7=9A=84=E9=A1=B9=E8=BF=9B=E8=A1=8C=E6=8E=92=E5=BA=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 2 +-
.../thirdparty/dictionary_of_item.md | 4 +-
.../thirdparty/historical_up_items.md | 4 +-
hoyolab/article/article.md | 28 +-
other/id.md | 30 +-
other/launcher.md | 435 +++++++++++++-----
6 files changed, 364 insertions(+), 139 deletions(-)
diff --git a/README.md b/README.md
index d27b3c9..419acb0 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)
+- [ ] [游戏启动器信息](other/launcher.md)
---
### 米游社（HoYoLab，MiYouShe）
diff --git a/genshin_impact/thirdparty/dictionary_of_item.md b/genshin_impact/thirdparty/dictionary_of_item.md
index 6402e50..3f3e8ab 100644
--- a/genshin_impact/thirdparty/dictionary_of_item.md
+++ b/genshin_impact/thirdparty/dictionary_of_item.md
@@ -1,7 +1,7 @@
# 项目ID与名称的字典
- [UIGF API](#uigf-api)
-- [Caughtwind API](#caughtwind-api)
+- [Caughtwind API](#caughtwind-api已弃用)
---
@@ -25,7 +25,7 @@ _请求方式：GET_
| --- | ---- | ---- | --- |
| “项目名称” | str | 项目ID | |
-## Caughtwind API
+## Caughtwind API（已弃用）
_请求方式：GET_
diff --git a/genshin_impact/thirdparty/historical_up_items.md b/genshin_impact/thirdparty/historical_up_items.md
index d06afab..b045ca1 100644
--- a/genshin_impact/thirdparty/historical_up_items.md
+++ b/genshin_impact/thirdparty/historical_up_items.md
@@ -1,10 +1,10 @@
# 历史祈愿UP池
-- [Caughtwind API](#caughtwind-api)
+- [Caughtwind API](#caughtwind-api已弃用)
---
-## Caughtwind API
+## Caughtwind API（已弃用）
_请求方式：GET_
diff --git a/hoyolab/article/article.md b/hoyolab/article/article.md
index 1214205..41a0dc4 100644
--- a/hoyolab/article/article.md
+++ b/hoyolab/article/article.md
@@ -227,7 +227,7 @@ _请求方式：GET_
| forum_id | num | 所属论坛的ID | |
| forum_name | str | 所属论坛的名称 | |
| banner | str | 文章封面链接 | |
-| view_type | num | 文章呈现类型
1 内容以文字类文章为主
2 内容以图片类文章为主
5 内容以视频类文章为主 | 文字类文章示例：[【V3.8攻略·七圣召唤】万叶、烟绯、坎蒂丝新卡一图流解读！-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41059886)
图片类文章示例：[「可莉」头像 一起来玩吧~~~~【观测枢】-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41214610)
视频类文章示例：[【欢愉一夏主题视频】3.8游园会BGM神还原~(观测枢)-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41175339) |
+| view_type | num | 文章呈现类型
1 内容以文字文章为主
2 内容以图片文章为主
5 内容以视频文章为主 | 文字类文章示例：[【V3.8攻略·七圣召唤】万叶、烟绯、坎蒂丝新卡一图流解读！-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41059886)
图片类文章示例：[「可莉」头像 一起来玩吧~~~~【观测枢】-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41214610)
视频类文章示例：[【欢愉一夏主题视频】3.8游园会BGM神还原~(观测枢)-原神社区-米游社 (miyoushe.com)](https://www.miyoushe.com/ys/article/41175339) |
@@ -683,8 +683,8 @@ _请求方式：GET_
`data`对象→`post`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------------------ | ----------- | -------------------------- | ----------------------------------- |
+| 字段 | 类型 | 内容 | 备注 |
+| --- | ---- | ---- | ---- |
| post | obj | 文章内容 | |
| forum | obj | 板块信息 | |
| topics | obj | 文章的标签 | |
@@ -802,14 +802,14 @@ _请求方式：GET_
`data`对象→`post`对象→`collection`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------------------- | ---- | ------------------------------ | ---- |
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | --- | ---- | --- |
| prev_post_id | str | 该集合下的上一篇文章的文章id | |
| next_post_id | str | 该集合下的下一篇文章的文章id | |
-| collection_id | str | 集合id | |
+| collection_id | str | 集合id | |
| cur | num | 当前文章在该集合下的指针 | |
| total | num | 该集合下的所有文章数量 | |
-| collection_title | str | 集合标题 | |
+| collection_title | str | 集合标题 | |
| prev_post_game_id | num | 该集合下的上一篇文章的游戏id | |
| next_post_game_id | num | 该集合下的下一篇文章的游戏id | |
| prev_post_view_type | num | 该集合下的上一篇文章的呈现类型 | |
@@ -1198,18 +1198,14 @@ _请求方式：GET_
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------------------------------------------------------ | ---- |
| type | num | 认证类别
1 社区或游戏官方
2 已认证的创作者
0 未认证的用户 | |
-| label | str | 认证具体信息 | |
+| label | str | 认证具体信息 | |
`data`对象→`list`数组→`user`对象→`level_exp`对象 或 `data`对象→`list`数组→对象→`sub_replies`对象→`user`对象→`level_exp`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ---- | -------------- | ---- |
-| level | num | 用户的社区等级 | |
-| exp | num | 用户的社区经验 | |
-
-
-
-
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | --- | --- | ----- |
+| level | num | 用户的社区等级 | |
+| exp | num | 用户的社区经验 | |
查看示例
diff --git a/other/id.md b/other/id.md
index 7afd2bd..ce065e8 100644
--- a/other/id.md
+++ b/other/id.md
@@ -13,7 +13,8 @@
- [绝区零](#forum-zenless-zone-zero)
- [子分区](#forum-sub-area)
- [视频分区](#forum-video-area)
-- [启动器ID以及key](#启动器ID以及key)
+- [文章类型](#文章类型)
+- [启动器ID与Key](#启动器ID与key)
- [原神](#原神)
- [服务器名称](#genshin-server-region)
- [角色ID](#genshin-characters)
@@ -35,14 +36,14 @@
| 6 | 崩坏：星穹铁道 | |
| 8 | 绝区零 | |
-## 启动器ID以及key
+## 启动器ID与Key
-| ID | 启动器 | key | 备注 |
-| ------ | ---- | --- | --- |
-| 33 | 崩坏：星穹铁道（官服） | 6KcVuOkbcqjJomjZ | |
-| 18 | 原神(官服) | eYd89JmJ | |
-| 17 | 原神(B服) | KAtdSsoQ | |
-| 10 | 原神(国际服) | gcStgarh | |
+| ID | Key | 游戏 | 服务器 | 备注 |
+| -- | --- | ---- | ----- | ---- |
+| 17 | KAtdSsoQ | 原神 | 哔哩哔哩服 | |
+| 18 | eYd89JmJ | 原神 | 官服 | |
+| 10 | gcStgarh | 原神 | 国际服 | |
+| 33 | 6KcVuOkbcqjJomjZ | 崩坏：星穹铁道 | 国服 | |
## 论坛ID
@@ -146,6 +147,13 @@
| 14 | 录屏·演示 | |
| 15 | 生活记录 | |
+## 文章类型
+
+| 名称 | 类型 | 备注 |
+| --- | ---- | ---- |
+| POST_TYPE_INFO | 以文本为主的文章 | |
+| POST_TYPE_ANNOUNCE | 公告文章 | |
+| POST_TYPE_ACTIVITY | 活动公告文章 | |
## 原神
@@ -162,9 +170,9 @@
角色ID
-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 | 角色 | 元素 | 国家 |
+
## 崩坏：星穹铁道
diff --git a/other/launcher.md b/other/launcher.md
index b6388ff..e6a3e6a 100644
--- a/other/launcher.md
+++ b/other/launcher.md
@@ -1,117 +1,224 @@
-# 启动器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`
+# 游戏启动器信息
+
+- [获取推荐内容](#获取推荐内容)
+
+---
+
+## 获取推荐内容
+
+_请求方式：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 | |
-| language | str | 语言 | 默认zh-cn |
-| filter_adv | bool | 是否为简略信息 | 默认fasle |
| launcher_id | num | 启动器ID | |
+| language | str | 返回文本语言的国家代码 | |
+| filter_adv | bool | 是否不获取背景图信息 | 留空则返回所有信息，即`false` |
**JSON返回：**
+
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| retcode | num | 返回码 | |
+| retcode | num | 返回码
-204 请求参数`launcher_id`的值无效
-205 请求参数`key`的值无效 | |
| message | str | 返回消息 | |
-| data | obj | 返回数据 | |
+| data | obj | 推荐信息 | 若请求参数中的`language`为不支持的语言，则所有数据均为空与空数组 |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| adv | obj | 玩家基础信息 | |
-| banner | list | 游戏资讯 | |
-| icon | list | 启动器侧边栏图标 | |
-| post | list | 好像也是游戏资讯 | |
-| qq | obj | 官方QQ群 | |
-| more | obj | 未知 | |
-| links | obj | faq | |
+| adv | obj | 背景图片信息 | |
+| banner | arr | 游戏资讯 | |
+| icon | arr | 启动器侧边栏图标及其信息 | |
+| post | arr | 最近的官方资讯文章信息 | |
+| qq | obj | 官方QQ群信息 | |
+| more | obj | 待调查 | |
+| links | obj | 常见问题页面的URL | |
`data`对象→`adv`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| background | str | 背景图URL | |
-| icon | str | 版本热点图片URL | |
-| url | str | 版本主题页 | |
-| version | str | 背景图版本 | 背景图变动时会变大 |
-| bg_checksum | str | 背景图哈希值 | 可能是md5 |
+| background | str | 背景图片的URL | 文件名中“_”字符前为该图片的MD5校验码 |
+| icon | str | 版本热点按钮图片的URL | |
+| url | str | 版本专题内容页面的URL | |
+| version | str | 背景图版本 | |
+| bg_checksum | str | 待调查 | 疑似为背景图片的校验码，但经过比对后，发现其与MD5和任何哈希散列算法通过图片内容生成的值无法匹配 |
`data`对象→`banner`数组→对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| banner_id | str | 未知 | |
-| name | null | 未知 | |
-| img | str | 文章头图 | |
-| url | str | 文章链接 | |
-| order | str | 可能是排序 | 1-10之间 |
+| banner_id | str | 待调查 | |
+| name | str | 待调查 | 似乎总是为空字符串 |
+| img | str | 文章封面图片的URL | |
+| url | str | 文章页面的URL | |
+| 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 | 未知 | 一般为空 |
+| icon_id | str | 待调查 | |
+| img | str | 图标URL | |
+| url | str | 该图标将会跳转至的URL | |
+| title | str | 二维码下方按钮的文本 | |
+| tittle | str | 与`title`字段的内容相同 | |
+| qr_img | str | 二维码图片URL | |
+| qr_desc | str | 二维码下方描述的文本 | |
+| img_hover | str | 鼠标悬停时显示图标的URL | |
+| other_links | arr | 待调查 | 似乎总是为空数组 |
+| links | arr | 二维码下方按钮的跳转URL | |
+| icon_link | str | 待调查 | 总是为空字符串 |
+
+`data`对象→`icon`数组→对象→`links`数组→对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| title | str | 按钮内文本 | |
+| url | str | 按钮将跳转的URL | |
`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群号 | |
-| name | str | 群名称 | |
-| code | str | 群链接 | |
-| qq_id | str | 未知 | |
+| name | str | QQ群名称 | |
+| code | str | QQ群URL | URL经过Unicode转义 |
`data`对象→`links`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| faq | str | faq链接 | |
-| version | str | 未知 | 一般为1 |
+| faq | str | 常见问题页面的URL | |
+| version | str | 待调查 | 总是为1 |
+
+
+查看示例
+
+```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"
+ }
+ }
+}
+```
+
### 获取游戏下载链接
-原神国服：`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`
+_请求方式：GET_
+
+《原神》国服：`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 | |
+| key | str | 启动器Key | |
+| launcher_id | num | 启动器ID | |
**JSON返回：**
@@ -121,90 +228,204 @@
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码 | |
| 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`对象：
+
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| latest | obj | 最新版本 | |
-| diffs | obj | 增量包 | |
-| web_url | str | 启动器首页？ | |
-| force_update | null | 未知 | |
-| pre_download_game | null | 未知 |
-| deprecated_packages | obj | 压缩包MD5 | |
-| sdk | null | 未知 |
-| deprecated_files | obj | 压缩包内部分文件MD5 | |
+| latest | obj | 最新版本文件信息 | |
+| diffs | arr | 一些旧版本至当前版本的增量文件信息 | |
`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 | 游戏入口 | |
+| version | str | 最新游戏版本 | |
+| name | str | 文件名称 | 总是为空字符串 |
+| path | str | 空字符串 | 根据`diffs`数组→对象→`path`字段的规律，本应为文件URL，但是被`segments`字段取代 |
+| size | str | 文件解压后的大小 | |
+| md5 | str | 该文件的MD5值 | |
+| voice_packs | arr | 所有语音包信息 | 《崩坏：星穹铁道》为空数组 |
+| decompressed_path | str | 待调查 | |
+| segments | arr | 游戏资源压缩文件各分卷的信息 | 《崩坏：星穹铁道》为空数组 |
+| package_size | str | 压缩包文件大小 | |
+| entry | str | 游戏启动程序的文件名 | |
`data`对象→`game`对象→`latest`对象→`voice_packs`数组→对象：
+
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| language | str | 语言 | |
-| path | str | 下载链接 | |
-| name | str | 语音包名称 | 一般为空 |
-| size | str | 解压后文件大小 | 单位为B |
-| package_size | 压缩包体积 | 单位为B |
-| md5 | str | 文件md5 | |
+| language | str | 语音资源对应的语言代码 | |
+| path | str | 该资源文件的URL | |
+| name | str | 语音包文件名称 | 总是为空字符串 |
+| size | str | 文件解压后的大小 | |
+| package_size | str | 压缩包文件大小 | |
+| md5 | str | 文件的MD5值 | |
`data`对象→`game`对象→`latest`对象→`segments`数组→对象：
+
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| path | str | 下载链接 | |
-| md5 | str | 文件md5 | |
-| package_size | 压缩包体积 | 单位为B |
+| path | str | 该资源文件的URL | |
+| md5 | str | 文件的MD5值 | |
+| package_size | str | 压缩包文件大小 | |
`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 | 语音包列表 | 崩坏：星穹铁道为空 |
+| version | str | 该增量包修补的旧版本 | |
+| path | str | 该增量包的URL | |
+| size | str | 文件解压后的大小 | |
+| md5 | str | 文件的MD5值 | |
+| package_size | str | 压缩包文件大小 | |
+| is_recommended_update | bool | 待调查 | |
+| voice_packs | obj | 所有语音增量包信息 | 《崩坏：星穹铁道》为空 |
`data`对象→`game`对象→`diffs`数组→`voice_packs`数组→对象：
-与`data`对象→`game`对象→`deprecated_packages`数组→对象中的结构相同
+与`data`对象→`game`对象→`latest`对象→`voice_packs`数组→对象的结构相同
`data`对象→`plugin`对象：
+
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| plugins | obj | 插件列表? | |
-| version | str | 版本号? | |
+| plugins | arr | 运行库信息 | |
+| version | str | 运行库版本 | |
`data`对象→`plugin`对象→`plugins`数组→对象：
+
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
-| name | str | 插件名称? | |
-| path | str | 下载链接 | |
-| md5 | str | 文件md5 | |
-| version | str | 文件版本号 | |
-| size | str | 文件大小 | 单位为B |
-| entry | str | 入口文件 | 可能为空 |
+| name | str | 运行库文件名 | |
+| path | str | 运行库文件URL | |
+| md5 | str | 文件的MD5值 | |
+| version | str | 该文件的版本 | 总是为空字符串 |
+| size | str | 文件大小 | |
+| entry | str | 运行库安装程序的文件名 | 可能为空字符串 |
`data`对象→`game`对象→`deprecated_packages`数组→对象：
+
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| name | str | 文件名 | |
-| md5 | str | 文件md5 | |
+| md5 | str | 文件的MD5值 | |
`data`对象→`game`对象→`deprecated_files`数组→对象：
-
-同：`data`对象→`game`对象→`deprecated_packages`数组→对象：
+
+与`data`对象→`game`对象→`deprecated_packages`数组→对象的结构相同
+
+
+查看示例
+
+```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": ""
+ },
+ ...
+ ]
+ }
+}
+```
+
\ No newline at end of file