【P】增加对LToken和SToken的不同版本的说明

【A】“用户标识符”文档增加“通过SToken获取LToken(V1)”和“通过SToken获取LToken(V1)”
This commit is contained in:
Kamisato-Ayaka-233 2023-09-10 17:06:49 +08:00
parent 0fdc7711e2
commit da0476968e
2 changed files with 130 additions and 7 deletions

View File

@ -1,11 +1,13 @@
# 用户Token
- [Token](#token)
- [通过Login Ticket获取SToken和LToken](#通过login-ticket获取stoken和ltoken)
- [通过Login Ticket获取STokenV1和LTokenV1](#通过login-ticket获取stokenv1和ltokenv1)
- [通过SToken获取Cookie Token](#通过stoken获取cookie-token)
- [通过Game Token获取SToken](#通过game-token获取stoken)
- [通过Game Token获取STokenV1](#通过game-token获取stokenv1)
- [通过Game Token获取Cookie Token](#通过game-token获取cookie-token)
- [通过Cookie Token获取Hk4e Token](#通过cookie-token获取hk4e-token)
- [通过STokenV1获取STokenV2](#通过stokenv1获取stokenv2)
- [通过SToken获取LTokenV1](#通过stoken获取ltokenv1)
- [Action Ticket](#action-ticket)
- [通过SToken获取Action Ticket](#通过stoken获取action-ticket)
- [Auth Key](#auth-key)
@ -16,7 +18,7 @@
## Token
### 通过Login Ticket获取SToken和LToken
### 通过Login Ticket获取STokenV1和LTokenV1
**国服:**
@ -130,7 +132,7 @@ _请求方式GET_
```
</details>
### 通过Game Token获取SToken
### 通过Game Token获取STokenV1
**国服:**
@ -331,6 +333,127 @@ _请求方式POST_
```
</details>
### 通过STokenV1获取STokenV2
**国服:**
_请求方式POST_
> _需要验证请求头_
>
> `x-rpc-app_id``bll8iq97cem8`
> _需要验证Cookie_
>
> SToken
`https://passport-api.mihoyo.com/account/ma-cn-session/app/getTokenBySToken`
**JSON返回**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码 | |
| message | str | 返回消息 | |
| data | obj | 该账号的STokenV2与部分账号个人信息 | 个人信息已隐藏 |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| token | obj | 该账号的STokenV2 | |
| user_info | obj | 部分账号个人信息 | 个人信息已隐藏 |
| need_realperson | bool | 待调查 | |
| realname_info | | 待调查 | |
`data`对象→`token`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| token_type | num | 1 | |
| token | str | 该账号的STokenV2 | |
<details>
<summary>查看示例</summary>
```json
{
"retcode": 0,
"message": "OK",
"data": {
"token": {
"token_type": 1,
"token": "***"
},
"user_info": {
"aid": "317832114",
"mid": "******",
"account_name": "",
"email": "****",
"is_email_verify": 1,
"area_code": "+86",
"mobile": "****",
"safe_area_code": "",
"safe_mobile": "",
"realname": "***",
"identity_code": "************",
"rebind_area_code": "",
"rebind_mobile": "",
"rebind_mobile_time": "0",
"links": [],
"country": ""
},
"realname_info": null,
"need_realperson": false
}
}
```
</details>
### 通过SToken获取LTokenV1
**国服:**
_请求方式GET_
> _需要验证Cookie_
>
> SToken
`https://passport-api.mihoyo.com/account/auth/api/getLTokenBySToken`
**JSON返回**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码 | |
| message | str | 返回消息 | |
| data | obj | 该账号的LTokenV1 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| ltoken | str | 该账号的LTokenV1 | |
<details>
<summary>查看示例</summary>
```json
{
"retcode": 0,
"message": "OK",
"data": {
"ltoken": "******"
}
}
```
</details>
## Action Ticket
### 通过SToken获取Action Ticket
@ -345,7 +468,7 @@ _请求方式GET_
`https://api-takumi.mihoyo.com/auth/api/getActionTicketBySToken`
**JSON请求**
**参数**
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |

View File

@ -360,7 +360,7 @@ const final = `${t},${r},${ds}` // 最终结果
即`ltoken_v2`和`ltoken`。
`ltoken_v2`和`ltoken`并不总是使用相同的值,多用于查询用户的游戏账号信息。
`ltoken_v2`和`ltoken`并不总是使用相同的值,多用于查询用户的游戏账号信息。其被命名为“LTokenV1”与“LTokenV2”。
`ltoken_v2`必须与[`ltmid_v2`](#mihoyo-id)一起使用,`ltoken`必须与[`ltuid`](#account-id)一起使用。
@ -380,7 +380,7 @@ const final = `${t},${r},${ds}` // 最终结果
#### MiHoYo ID
分为与[LToken](#ltoken)一起使用的`ltmid_v2`,和与[SToken](#stoken)一起使用的`mid`
分为与[LToken](#ltoken)一起使用的`ltmid_v2`,和与[SToken](#stoken)一起使用的`mid`。其被命名为“STokenV1”与“STokenV2”。
`ltmid_v2`和`mid`的值是相同,对应一个账号。