mirror of
https://github.com/PaiGramTeam/mihoyo-api-collect.git
synced 2024-11-26 01:50:45 +00:00
- 【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:
parent
f962ddfdbb
commit
6b9a456417
@ -1833,7 +1833,7 @@ _请求方式:GET_
|
|||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---- | ---- | ---- | ---- |
|
| ---- | ---- | ---- | ---- |
|
||||||
| authkey_ver | num | 1 | |
|
| 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>以及其它国际语言代码 | |
|
| 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个数据 | |
|
| size | num | 返回数据中的最大数据数量。最小为0,最大为20。若小于0,则返回0个数据;若大于20,则返回最大20个数据 | |
|
||||||
| end_id | num | 见下文的说明 | |
|
| end_id | num | 见下文的说明 | |
|
||||||
@ -2042,7 +2042,7 @@ _请求方式:GET_
|
|||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---- | ---- | ---- | ---- |
|
| ---- | ---- | ---- | ---- |
|
||||||
| authkey_ver | num | 1 | |
|
| 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>以及其它国际语言代码 | |
|
| 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个数据 | |
|
| size | num | 返回数据中的最大数据数量。最小为0,最大为20。若小于0,则返回0个数据;若大于20,则返回最大20个数据 | |
|
||||||
| end_id | num | 见下文的说明 | |
|
| end_id | num | 见下文的说明 | |
|
||||||
@ -2083,16 +2083,16 @@ _请求方式:GET_
|
|||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---- | ---- | ---- | ---- |
|
| ---- | ---- | ---- | ---- |
|
||||||
| uid | str | 该玩家的UID | |
|
| uid | str | 该玩家的UID | |
|
||||||
| gacha_id | str | 待调查 | |
|
| gacha_id | str | 该跃迁记录所在的跃迁池的ID | |
|
||||||
| gacha_type | str | 跃迁池 | |
|
| gacha_type | str | 跃迁池 | 与请求参数中的`gacha_type`参数的值相同 |
|
||||||
| item_id | str | 该项目的ID | |
|
| item_id | str | 该项目的ID | |
|
||||||
| count | str | 1 | |
|
| count | str | 1 | |
|
||||||
| time | str | 该玩家抽到该项目的日期 | |
|
| time | str | 该玩家抽到该项目的日期 | |
|
||||||
| name | str | 抽到的项目名称 | 文本语言通过参数`lang`指定 |
|
| name | str | 抽到的项目名称 | 文本语言通过参数`lang`指定 |
|
||||||
| lang | str | 语言 | 与请求参数中的`lang`参数的值相同 |
|
| lang | str | 语言 | 与请求参数中的`lang`参数的值相同 |
|
||||||
| item_type | str | 该项目的类别 | 文本语言通过参数`lang`指定 |
|
| item_type | str | 该项目的类别 | 文本语言通过参数`lang`指定 |
|
||||||
| rank_type | str | 3 | |
|
| rank_type | str | 该项目的稀有度 | |
|
||||||
| id | str | 似乎前10位数字为接近于抽到该项目的时间的Unix时间戳,后面的数字含义未知 | |
|
| id | str | 该跃迁记录的ID,可用于翻页获取跃迁记录 | |
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary>查看示例</summary>
|
<summary>查看示例</summary>
|
||||||
|
@ -7,8 +7,8 @@
|
|||||||
- [通过Game Token获取Cookie Token](#通过game-token获取cookie-token)
|
- [通过Game Token获取Cookie Token](#通过game-token获取cookie-token)
|
||||||
- [通过Cookie Token获取Hk4e Token](#通过cookie-token获取hk4e-token)
|
- [通过Cookie Token获取Hk4e Token](#通过cookie-token获取hk4e-token)
|
||||||
- [Auth Key](#auth-key)
|
- [Auth Key](#auth-key)
|
||||||
- [通过SToken获取用户Auth Key A](#通过stoken获取账号auth-key-a)
|
- [通过SToken获取账号Auth Key A](#通过stoken获取账号auth-key-a)
|
||||||
- [通过SToken获取用户Auth Key B](#通过stoken获取账号auth-key-b)
|
- [通过SToken获取账号Auth Key B](#通过stoken获取账号auth-key-b)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -277,20 +277,37 @@ _请求方式:POST_
|
|||||||
>
|
>
|
||||||
> Cookie Token:`cookie_token`
|
> 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返回:**
|
**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>
|
<details>
|
||||||
<summary>查看示例</summary>
|
<summary>查看示例</summary>
|
||||||
@ -338,7 +355,7 @@ _请求方式:POST_
|
|||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---- | ---- | ---- | ---- |
|
| ---- | ---- | ---- | ---- |
|
||||||
| retcode | num | 返回码<br>1002 请求体的`game_biz`字段不正确 | |
|
| retcode | num | 返回码<br>1002 请求体中有字段不正确 | |
|
||||||
| message | str | 返回消息 | |
|
| message | str | 返回消息 | |
|
||||||
| data | obj | Auth Key A | |
|
| data | obj | Auth Key A | |
|
||||||
|
|
||||||
@ -383,7 +400,7 @@ _请求方式:POST_
|
|||||||
>
|
>
|
||||||
> `x-rpc-client_type`:`2`
|
> `x-rpc-client_type`:`2`
|
||||||
>
|
>
|
||||||
> LK`salt`
|
> K2`salt`
|
||||||
>
|
>
|
||||||
> `DS1`
|
> `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 | |
|
| game_uid | num | 用户的游戏UID | |
|
||||||
|
| region | str | 用户游戏ID对应的服务器的名称 | |
|
||||||
|
| auth_appid | str | 获取的Auth Key B的类型<br>im_ccs 米游社<br>csc 米游社联系客服页面<br>webview_gacha 游戏抽卡记录 | |
|
||||||
|
|
||||||
**JSON返回:**
|
**JSON返回:**
|
||||||
|
|
||||||
@ -407,7 +426,7 @@ _请求方式:POST_
|
|||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---- | ---- | ---- | ---- |
|
| ---- | ---- | ---- | ---- |
|
||||||
| retcode | num | 返回码<br>1002 请求体的`game_biz`字段不正确 | |
|
| retcode | num | 返回码<br>1002 请求体中有字段不正确<br>1016 游戏账号未绑定Cookie对应的账号 | |
|
||||||
| message | str | 返回消息 | |
|
| message | str | 返回消息 | |
|
||||||
| data | obj | Auth Key B | |
|
| data | obj | Auth Key B | |
|
||||||
|
|
||||||
|
@ -15,6 +15,7 @@
|
|||||||
| 1008 | 用户信息不匹配 | 传递的参数不正确<br/>(例如获取用户游戏账号信息的`role_id`为无效UID) |
|
| 1008 | 用户信息不匹配 | 传递的参数不正确<br/>(例如获取用户游戏账号信息的`role_id`为无效UID) |
|
||||||
| 10001 | Please login | 该API需要验证Cookie<br/>请查看[绕过检测与鉴权](other/authentication.md#cookie) |
|
| 10001 | Please login | 该API需要验证Cookie<br/>请查看[绕过检测与鉴权](other/authentication.md#cookie) |
|
||||||
| 1034 | | 请求遇到验证码 |
|
| 1034 | | 请求遇到验证码 |
|
||||||
|
|
||||||
### `api-takumi.miyoushe.com`
|
### `api-takumi.miyoushe.com`
|
||||||
|
|
||||||
| 错误码 | 消息 | 原因 |
|
| 错误码 | 消息 | 原因 |
|
||||||
@ -22,6 +23,7 @@
|
|||||||
| -10001 | invalid request | 该API需要验证请求头,请求头的一些字段缺失或错误<br/>请查看[绕过检测与鉴权](other/authentication.md) |
|
| -10001 | invalid request | 该API需要验证请求头,请求头的一些字段缺失或错误<br/>请查看[绕过检测与鉴权](other/authentication.md) |
|
||||||
| -502 | Something went wrong...please retry later | 传递的参数错误 |
|
| -502 | Something went wrong...please retry later | 传递的参数错误 |
|
||||||
| -100 | 登录失效,请重新登录 | Cookie失效或不正确 |
|
| -100 | 登录失效,请重新登录 | Cookie失效或不正确 |
|
||||||
|
| 1002 | 系统异常 | 传递的参数错误,或者米游社系统异常 |
|
||||||
| 1034 | | 请求遇到验证码 |
|
| 1034 | | 请求遇到验证码 |
|
||||||
|
|
||||||
### `api-takumi.mihoyo.com`
|
### `api-takumi.mihoyo.com`
|
||||||
@ -29,6 +31,7 @@
|
|||||||
| 错误码 | 消息 | 原因 |
|
| 错误码 | 消息 | 原因 |
|
||||||
| ----- | ---- | ---- |
|
| ----- | ---- | ---- |
|
||||||
| -502 | Something went wrong...please retry later | 传递的参数错误 |
|
| -502 | Something went wrong...please retry later | 传递的参数错误 |
|
||||||
|
| -111 | 登录失效,请重新登录 | Cookie失效或不正确 |
|
||||||
| -101 | 参数错误 | 传递的参数缺失或错误 |
|
| -101 | 参数错误 | 传递的参数缺失或错误 |
|
||||||
| -100 | 登录失效,请重新登录<br>-100 | Cookie失效或不正确 |
|
| -100 | 登录失效,请重新登录<br>-100 | Cookie失效或不正确 |
|
||||||
| 1000 | 参数错误 | 传递的参数缺失或错误 |
|
| 1000 | 参数错误 | 传递的参数缺失或错误 |
|
Loading…
Reference in New Issue
Block a user