- 【F】通过Cookie Token获取Hk4e Token

- 【F】新增错误码
- 【I】修改游戏抽卡记录API中的跨页面标题跳转的错误链接
- 【I】修改通过SToken获取Auth Key B的请求头`x-rpc-client_type`标识错误
- 【I】修改获取游戏抽卡记录API的`authkey`参数的描述
This commit is contained in:
Kamisato-Ayaka-233 2023-06-21 18:52:30 +08:00
parent f962ddfdbb
commit 6b9a456417
3 changed files with 38 additions and 16 deletions

View File

@ -1833,7 +1833,7 @@ _请求方式GET_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| authkey_ver | num | 1 | |
| authkey | str | 验证密钥,用于标识游戏账号 | 获取方法:<br>1. 游戏内打开一次跃迁记录页面,然后在“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”寻找类似“<https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……>”的链接,该参数的值在其中<br>2. [通过Cookie获取用户`authkey`B](hoyolab/user/info.md#通过cookie获取用户authkeyb) |
| authkey | str | 用于标识游戏账号的Auth Key B | 获取方法:<br>1. 游戏内打开一次祈愿记录页面,然后在“游戏安装目录/YuanShen_Data/webCaches/Cache/Cache_Data/data_2”寻找类似“<https://hk4e-api.mihoyo.com/event/gacha_info/api/getGachaLog……>”的链接,该参数的值在其中<br>2. [通过SToken获取账号Auth Key B](hoyolab/user/token.md#通过stoken获取账号auth-key-b)使请求体字段`auth_appid`为`webview_gacha` |
| lang | str | 语言,即返回数据中抽到的项目名称<br>zh-cn zh 简体中文<br>zh-tw 繁体中文<br>en-us en 英语<br>ru-ru ru 俄语<br>ja-jp ja 日语<br>以及其它国际语言代码 | |
| size | num | 返回数据中的最大数据数量。最小为0最大为20。若小于0则返回0个数据若大于20则返回最大20个数据 | |
| end_id | num | 见下文的说明 | |
@ -2042,7 +2042,7 @@ _请求方式GET_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| authkey_ver | num | 1 | |
| authkey | str | 验证密钥,用于标识游戏账号 | 获取方法:<br>1. 游戏内打开一次跃迁记录页面,然后在“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”寻找类似“<https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……>”的链接,该参数的值在其中<br>2. [通过Cookie获取用户`authkey`B](hoyolab/user/info.md#通过cookie获取用户authkeyb) |
| authkey | str | 用于标识游戏账号的Auth Key B | 获取方法:<br>1. 游戏内打开一次跃迁记录页面,然后在“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”寻找类似“<https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……>”的链接,该参数的值在其中<br>2. [通过SToken获取账号Auth Key B](hoyolab/user/token.md#通过stoken获取账号auth-key-b)使请求体字段`auth_appid`为`webview_gacha` |
| lang | str | 语言,即返回数据中抽到的项目名称<br>zh-cn zh 简体中文<br>zh-tw 繁体中文<br>en-us en 英语<br>ru-ru ru 俄语<br>ja-jp ja 日语<br>以及其它国际语言代码 | |
| size | num | 返回数据中的最大数据数量。最小为0最大为20。若小于0则返回0个数据若大于20则返回最大20个数据 | |
| end_id | num | 见下文的说明 | |
@ -2083,16 +2083,16 @@ _请求方式GET_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| uid | str | 该玩家的UID | |
| gacha_id | str | 待调查 | |
| gacha_type | str | 跃迁池 | |
| gacha_id | str | 该跃迁记录所在的跃迁池的ID | |
| gacha_type | str | 跃迁池 | 与请求参数中的`gacha_type`参数的值相同 |
| item_id | str | 该项目的ID | |
| count | str | 1 | |
| time | str | 该玩家抽到该项目的日期 | |
| name | str | 抽到的项目名称 | 文本语言通过参数`lang`指定 |
| lang | str | 语言 | 与请求参数中的`lang`参数的值相同 |
| item_type | str | 该项目的类别 | 文本语言通过参数`lang`指定 |
| rank_type | str | 3 | |
| id | str | 似乎前10位数字为接近于抽到该项目的时间的Unix时间戳后面的数字含义未知 | |
| rank_type | str | 该项目的稀有度 | |
| id | str | 该跃迁记录的ID可用于翻页获取跃迁记录 | |
<details>
<summary>查看示例</summary>

View File

@ -7,8 +7,8 @@
- [通过Game Token获取Cookie Token](#通过game-token获取cookie-token)
- [通过Cookie Token获取Hk4e Token](#通过cookie-token获取hk4e-token)
- [Auth Key](#auth-key)
- [通过SToken获取用户Auth Key A](#通过stoken获取账号auth-key-a)
- [通过SToken获取用户Auth Key B](#通过stoken获取账号auth-key-b)
- [通过SToken获取账号Auth Key A](#通过stoken获取账号auth-key-a)
- [通过SToken获取账号Auth Key B](#通过stoken获取账号auth-key-b)
---
@ -277,20 +277,37 @@ _请求方式POST_
>
> Cookie Token`cookie_token`
`https://api-takumi.mihoyo.com/auth/api/getCookieAccountInfoByGameToken`
`https://api-takumi.mihoyo.com/common/badge/v1/login/account`
**参数**
**JSON请求**
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| account_id | num | 对应的米游社账号UID | |
| region | str | 《原神》账号对应的服务器名称 | |
| uid | str | Cookie对应米游社账号已绑定的《原神》账号的UID | |
| game_biz | str | hk4e_cn | |
**JSON返回**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码<br>-1002 游戏账号未绑定Cookie对应的账号 | |
| message | str | 返回消息 | |
| data | obj | 《原神》账号的基础信息 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| game | str | hk4e | |
| region | str | 《原神》账号对应的服务器的名称 | |
| game_uid | str | 《原神》账号的UID | |
| game_biz | str | hk4e_cn | |
| level | num | 《原神》账号的冒险等级 | |
| nickname | str | 《原神》账号昵称 | |
| region_name | str | 《原神》账号对应服务器的称呼 | |
<details>
<summary>查看示例</summary>
@ -338,7 +355,7 @@ _请求方式POST_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码<br>1002 请求体的`game_biz`字段不正确 | |
| retcode | num | 返回码<br>1002 请求体中有字段不正确 | |
| message | str | 返回消息 | |
| data | obj | Auth Key A | |
@ -383,7 +400,7 @@ _请求方式POST_
>
> `x-rpc-client_type``2`
>
> LK`salt`
> K2`salt`
>
> `DS1`
@ -398,8 +415,10 @@ _请求方式POST_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| game_biz | str | 获取的`authkey`B的游戏<br>hk4e_cn 《原神》国服<br>hkrpg_cn 《崩坏:星穹铁道》国服<br> | |
| game_biz | str | 获取的Auth Key B的游戏<br>hk4e_cn 《原神》国服<br>hkrpg_cn 《崩坏:星穹铁道》国服<br> | |
| game_uid | num | 用户的游戏UID | |
| region | str | 用户游戏ID对应的服务器的名称 | |
| auth_appid | str | 获取的Auth Key B的类型<br>im_ccs 米游社<br>csc 米游社联系客服页面<br>webview_gacha 游戏抽卡记录 | |
**JSON返回**
@ -407,7 +426,7 @@ _请求方式POST_
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| retcode | num | 返回码<br>1002 请求体的`game_biz`字段不正确 | |
| retcode | num | 返回码<br>1002 请求体中有字段不正确<br>1016 游戏账号未绑定Cookie对应的账号 | |
| message | str | 返回消息 | |
| data | obj | Auth Key B | |

View File

@ -15,6 +15,7 @@
| 1008 | 用户信息不匹配 | 传递的参数不正确<br/>(例如获取用户游戏账号信息的`role_id`为无效UID |
| 10001 | Please login | 该API需要验证Cookie<br/>请查看[绕过检测与鉴权](other/authentication.md#cookie) |
| 1034 | | 请求遇到验证码 |
### `api-takumi.miyoushe.com`
| 错误码 | 消息 | 原因 |
@ -22,6 +23,7 @@
| -10001 | invalid request | 该API需要验证请求头请求头的一些字段缺失或错误<br/>请查看[绕过检测与鉴权](other/authentication.md) |
| -502 | Something went wrong...please retry later | 传递的参数错误 |
| -100 | 登录失效,请重新登录 | Cookie失效或不正确 |
| 1002 | 系统异常 | 传递的参数错误,或者米游社系统异常 |
| 1034 | | 请求遇到验证码 |
### `api-takumi.mihoyo.com`
@ -29,6 +31,7 @@
| 错误码 | 消息 | 原因 |
| ----- | ---- | ---- |
| -502 | Something went wrong...please retry later | 传递的参数错误 |
| -111 | 登录失效,请重新登录 | Cookie失效或不正确 |
| -101 | 参数错误 | 传递的参数缺失或错误 |
| -100 | 登录失效,请重新登录<br>-100 | Cookie失效或不正确 |
| 1000 | 参数错误 | 传递的参数缺失或错误 |