Merge branch 'main' of https://github.com/Kamisato-Ayaka-233/mihoyo-api-collect

2024-11-21 22:58:03 +00:00 · 2023-09-10 17:08:48 +08:00 · 2023-09-10 17:08:48 +08:00 · 469126cfcf
commit 469126cfcf
parent da0476968e 1f36201f63
4 changed files with 228 additions and 4 deletions
--- 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已弃用)

 ---

@ -43,4 +43,4 @@ _请求方式：GET_

 | 字段 | 类型 | 内容 | 备注 |
 | --- | ---- | ---- | --- |
-| “项目名称” | str | 项目ID | |
+| “项目名称” | str | 项目ID | |
--- a/hoyolab/login/password_hoyolab.md
+++ b/hoyolab/login/password_hoyolab.md
@ -0,0 +1,224 @@
+# 米游社密码登录
+
+- [密码登录](#密码登录)
+  - [操作步骤](#操作步骤)
+  - [获取设备指纹信息（device_fp）](#获取设备指纹信息)
+  - [发送登录请求](#发送登录请求)
+
+---
+
+## 密码登录
+
+### 操作步骤
+
+1. [获取设备指纹信息](#获取设备指纹信息)，记录返回`data`对象的`device_fp。
+2. 向服务器传入账号密码以获取登录信息。
+
+### 获取设备指纹信息
+
+**国服：**
+
+_请求方式：POST_
+
+`https://public-data-api.mihoyo.com/device-fp/api/getFp`
+
+**JSON请求：**
+
+| 字段       | 类型 | 内容                                | 备注                                                      |
+| ---------- | ---- | ----------------------------------- | --------------------------------------------------------- |
+| device_id  | str  | 设备id                              |                                                           |
+| seed_id    | str  | 种子id                              | 可随机生成                                                |
+| seed_time  | str  | 当前UNIX时间戳                      |                                                           |
+| platform   | str  | 设备平台                            | 不同的设备平台需要包含的拓展字段内容不同                      |
+| device_fp  | str  | 设备指纹信息                        | 可随机生成                                                |
+| app_name   | str  | 请求的应用名称<br />  bbs_cn 米游社 |                                                           |
+| ext_fields | str  | 拓展字段                            | 为使用字符串包裹的 json 字段，若platform为4则必须包含 userAgent 字段，若platform为2则需要包含['cpuType', 'romCapacity', 'productName', 'romRemain', 'manufacturer', 'appMemory', 'hostname', 'screenSize', 'osVersion', 'aaid', 'vendor', 'accelerometer', 'buildTags', 'model', 'brand', 'oaid', 'hardware', 'deviceType', 'devId', 'serialNumber', 'buildTime', 'buildUser', 'ramCapacity', 'magnetometer', 'display', 'ramRemain', 'deviceInfo', 'gyroscope', 'vaid', 'buildType', 'sdkVersion', 'board']字段 |
+
+<details>
+<summary>查看示例</summary>
+
+```json
+{
+    "device_id": "2d356b22f39b708c",
+    "seed_id": "d81de6f4-6aa3-4e5f-b8e8-6a4f98e15a76",
+    "seed_time": "1692248006205",
+    "platform": "2",
+    "device_fp": "38d7efe8b7f79",
+    "app_name": "bbs_cn",
+    "ext_fields": "{
+		\"cpuType\":\"arm64-v8a\",
+		\"romCapacity\":\"512\",
+		\"productName\":\"ishtar\",
+		\"romRemain\":\"459\",
+		\"manufacturer\":\"Xiaomi\",
+		\"appMemory\":\"512\",
+		\"hostname\":\"xiaomi.eu\",
+		\"screenSize\":\"1440x3022\",
+		\"osVersion\":\"13\",
+		\"aaid\":\"a945fe0c-5f49-4481-9ee8-418e74508414\",
+		\"vendor\":\"中国电信\",
+		\"accelerometer\":\"0.061016977x0.8362915x9.826724\",
+		\"buildTags\":\"release-keys\",
+		\"model\":\"2304FPN6DC\",
+		\"brand\":\"Xiaomi\",
+		\"oaid\":\"67b292338ad57a24\",
+		\"hardware\":\"qcom\",
+		\"deviceType\":\"ishtar\",
+		\"devId\":\"REL\",
+		\"serialNumber\":\"unknown\",
+		\"buildTime\":\"1690889245000\",
+		\"buildUser\":\"builder\",
+		\"ramCapacity\":\"229481\",
+		\"magnetometer\":\"80.64375x-14.1x77.90625\",
+		\"display\":\"TKQ1.221114.001 release-keys\",
+		\"ramRemain\":\"110308\",
+		\"deviceInfo\":"Xiaomi/ishtar/ishtar:13/TKQ1.221114.001/V14.0.17.0.TMACNXM:user/release-keys",
+		\"gyroscope\":\"7.9894776E-4x-1.3315796E-4x6.6578976E-4\",
+		\"vaid\":\"4c10d338150078d8",
+		\"buildType\":\"user\",
+		\"sdkVersion\":\"33\",
+		\"board\":\"kalama\"
+	}",
+    "bbs_device_id": "b66a6178-f56d-30ed-97aa-297560c98fc1"
+}
+```
+
+</details>
+
+**JSON 返回：**
+
+根对象：
+
+| 字段    | 类型 | 内容             | 备注 |
+| ------- | ---- | --------------- | ---- |
+| retcode | num  | 返回码          | -502 传入的内容有误 |
+| message | str  | 返回消息         |      |
+| data    | obj  | 设备指纹 |      |
+
+`data`对象：
+
+| 字段   | 类型 | 内容               | 备注                |
+| ------ | ---- | ------------------ | ------------------- |
+| device_fp | str  | 设备指纹 |  |
+| code | num | 回传的http状态码 |                     |
+| msg | str | 错误消息 | |
+
+<details>
+<summary>查看示例</summary>
+
+```json
+{
+    'data':{
+            	'code': 200, 
+           		'device_fp': 'ui33vcedffou', 
+            	'msg': 'ok'
+        	},
+ 	'message': 'OK',
+ 	'retcode': 0
+}
+```
+
+</details>
+
+### 获取登录信息
+
+**国服：**
+
+_请求方式：POST_
+
+> _需要验证请求头_
+>
+> `x-rpc-app_id`：`bll8iq97cem8`
+>
+> `x-rpc-client_type`：`2`
+>
+> `x-rpc-game_biz`：`bbs_cn`
+>
+> `x-rpc-device_fp`
+>
+> `x-rpc-device_id`
+>
+> *其中`x-rpc-device_fp`的值为刚才获取的`device_fp`的值*
+
+`https://passport-api.mihoyo.com/account/ma-cn-passport/app/loginByPassword`
+
+**JSON请求：**
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| account | str | 要登录的账户 | 使用RSA + Base64加密，加密方式[详见该页面](password_passport.md#%E8%8E%B7%E5%8F%96login-ticket) |
+| password | str | 密码 | 使用RSA + Base64加密，加密方式[详见该页面](password_passport.md#%E8%8E%B7%E5%8F%96login-ticket) |
+
+**JSON返回：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| retcode | num | 返回码<br> | |
+| message | str | 返回消息 | |
+| data | obj | 账户信息| |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| login_ticket    | str  | Login Ticket             |      |
+| need_realperson | str  | 是否要求用户进行实名认证 |      |
+| token           | obj  | 包含stoken_v2?的对象  |      |
+| user_info       | obj  | 用户信息                 |      |
+
+`user_info`对象：
+
+| 字段            | 类型 | 内容                                         | 备注         |
+| --------------- | ---- | -------------------------------------------- | ------------ |
+| account_name    | str  | 账户名                                       | 国服默认为空 |
+| aid             | str  | Account ID                                   |              |
+| area_code       | str  | 账户所绑定的电话号码对应的国家区号           |              |
+| country         | str  | 国家                                         | 国服默认为空 |
+| email           | str  | 账户所绑定的邮箱                             |              |
+| identity_code   | str  | 身份证号码                                   |              |
+| is_email_verify | str  | 邮箱是否认证通过<br />1 已认证<br />0 未认证 |              |
+| links           | str  | 第三方绑定信息                               |              |
+| mid             | str  | MiHoYo ID                                    |              |
+| mobile          | str  | 账户所绑定的电话号码                         |              |
+| realname        | str  | 用户的真实姓名                               |              |
+
+<details>
+<summary>查看示例</summary>
+
+```json
+{
+    'data': {'login_ticket': '***',
+          'need_realperson': False,
+          'reactivate_info': {'required': False, 'ticket': ''},
+          'realname_info': {'action_ticket': '',
+                            'action_type': '',
+                            'required': False},
+          'token': {'token': '***',
+                    'token_type': 1},
+          'user_info': {'account_name': '',
+                        'aid': '311526738',
+                        'area_code': '+86',
+                        'country': '',
+                        'email': '***@***.****',
+                        'identity_code': '******************',
+                        'is_email_verify': 1,
+                        'links': [{'email': '',
+                                   'nickname': '***',
+                                   'subType': '',
+                                   'thirdparty': 'tp',
+                                   'union_id': '***'}],
+                        'mid': '0d5cf7piru_mhy',
+                        'mobile': '***********',
+                        'realname': '***',
+                        'rebind_area_code': '',
+                        'rebind_mobile': '',
+                        'rebind_mobile_time': '0',
+                        'safe_area_code': '',
+                        'safe_mobile': ''}},
+ 'message': 'OK',
+ 'retcode': 0
+}
+```
+</details>
--- a/hoyolab/login/password_passport.md
+++ b/hoyolab/login/password_passport.md
@ -1,4 +1,4 @@
-# 米游社密码登录
+# 米哈游通行证密码登录

 - [密码登录](#密码登录)
  - [操作步骤](#pwd-step)
--- a/other/error_code.md
+++ b/other/error_code.md
@ -36,7 +36,7 @@
 | -100 | 登录失效，请重新登录<br>-100 | Cookie失效或不正确 |
 | 1000 | 参数错误 | 传递的参数缺失或错误 |

-# `api-launcher.mihoyo.com`
+### `api-launcher.mihoyo.com`

 | 错误码 | 消息 | 原因 |
 | ----- | ---- | ---- |