PaiGramTeam/mihoyo-api-collect
3
0
Fork 0
mirror of https://github.com/PaiGramTeam/mihoyo-api-collect.git synced 2024-11-25 17:48:07 +00:00
Code Issues Packages Projects Releases Wiki Activity
d31c3acf04
mihoyo-api-collect/hoyolab/user/token.md

10 KiB
Raw Blame History

用户Token

Token

通过Login Ticket获取SToken和LToken

国服：

请求方式：GET

https://api-takumi.mihoyo.com/auth/api/getMultiTokenByLoginTicket

参数：

字段 类型 内容 备注
token_types num 获取的Token的类型
1 仅SToken
2 仅LToken
3 SToken和LToken
4 无
login_ticket str 有效的Login Ticket
uid num 对应的米游社账号UID

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
message str 返回消息
data obj Token

data对象：

字段 类型 内容 备注
list arr SToken或LToken

data对象→list数组→对象：

字段 类型 内容 备注
name str Token类型
ltoken LToken
stoken SToken
token str Token值
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "list": [
      {
        "name": "stoken",
        "token": "***"
      },
      {
        "name": "ltoken",
        "token": "***"
      }
    ]
  }
}

通过SToken获取Cookie Token

国服：

请求方式：GET

需要验证Cookie

SToken

https://api-takumi.mihoyo.com/auth/api/getCookieAccountInfoBySToken

参数：

字段 类型 内容 备注
stoken str 有效的SToken
uid num 对应的米游社账号UID

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
message str 返回消息
data obj Cookie Token和米游社UID

data对象：

字段 类型 内容 备注
uid str 米游社UID
cookie_token str SToken对应账号的Cookie Token
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "uid": "***",
    "cookie_token": "***"
  }
}

通过Game Token获取SToken

国服：

请求方式：POST

需要验证请求头

x-rpc-app_id

https://api-takumi.mihoyo.com/account/ma-cn-session/app/getTokenByGameToken

JSON请求：

字段 类型 内容 备注
account_id num 对应的米游社账号UID
game_token str 有效的Game Token

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
-3005 未传递x-rpc-app_id请求头
message str 返回消息
data obj 账号的Token与隐私信息

data对象：

字段 类型 内容 备注
token obj 米游社账号的SToken
user_info obj 米游社账号敏感信息 一些个人信息已被隐藏
realname_info 待调查
need_realperson bool 待调查

data对象→token对象：

字段 类型 内容 备注
token_type num 1
token str 账号的SToken

data对象→user_info对象：

字段 类型 内容 备注
aid str 米游社UID
mid str 米游社MiHoYo ID
account_name str 空字符串
email str 被隐藏的账号的绑定邮箱
is_email_verify num 绑定邮箱是否通过验证
area_code str 账号绑定手机的区号
mobile str 被隐藏的账号的绑定手机
safe_area_code str 账号安全手机的区号 历史遗留字段，现在安全手机的功能已经被移除了
safe_mobile str 被隐藏的账号安全手机 历史遗留字段，现在安全手机的功能已经被移除了
realname str 被隐藏的账号实名认证姓名
identity_code str 被隐藏的账号实名认证身份证号
rebind_area_code str 账号的换绑手机号的区号
rebind_mobile str 被隐藏的账号的换绑手机号
rebind_mobile_time str 0
links arr 待调查
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "token": {
      "token_type": 1,
      "token": "***"
    },
    "user_info": {
      "aid": "*******",
      "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": []
    },
    "realname_info": null,
    "need_realperson": false
  }
}

通过Game Token获取Cookie Token

国服：

请求方式：GET

https://api-takumi.mihoyo.com/auth/api/getCookieAccountInfoByGameToken

参数：

字段 类型 内容 备注
account_id num 对应的米游社账号UID
game_token str 有效的Game Token

JSON返回：

根对象：

与通过SToken获取Cookie Token→根对象的结构相同。

查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "uid": "***",
    "cookie_token": "***"
  }
}

通过Cookie Token获取Hk4e Token

国服：

请求方式：POST

需要验证Cookie

Account ID：account_id

Cookie Token：cookie_token

https://api-takumi.mihoyo.com/common/badge/v1/login/account

JSON请求：

字段 类型 内容 备注
region str 《原神》账号对应的服务器名称
uid str Cookie对应米游社账号已绑定的《原神》账号的UID
game_biz str hk4e_cn

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
-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 《原神》账号对应服务器的称呼
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "game": "hk4e",
    "region": "cn_gf01",
    "game_uid": "222681079",
    "game_biz": "hk4e_cn",
    "level": 58,
    "nickname": "※青衫入雨※",
    "region_name": "天空岛"
  }
}

Auth Key

通过SToken获取账号Auth Key A

国服：

请求方式：POST

需要验证Cookie

SToken

https://api-takumi.miyoushe.com/account/auth/api/genAuthKey

JSON请求：

字段 类型 内容 备注
game_biz str 米游社区域
bbs_cn 国服

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
1002 请求体中有字段不正确
message str 返回消息
data obj Auth Key A

data对象：

字段 类型 内容 备注
sign_type num 2
authkey_ver num 1
authkey str Auth Key A
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "sign_type": 2,
    "authkey_ver": 1,
    "authkey": "***"
  }
}

国际服：

未知

通过SToken获取账号Auth Key B

用例：获取用户的游戏抽卡记录等API需要使用到Auth Key B。

国服：

请求方式：POST

需要验证请求头

x-rpc-client_type：5

LK2salt

DS1

需要验证Cookie

SToken

https://api-takumi.miyoushe.com/binding/api/genAuthKey

JSON请求：

字段 类型 内容 备注
game_biz str 获取的Auth Key B的游戏
hk4e_cn 《原神》国服
hkrpg_cn 《崩坏：星穹铁道》国服
game_uid num 用户的游戏UID
region str 用户游戏ID对应的服务器的名称
auth_appid str 获取的Auth Key B的类型
im_ccs 米游社
csc 米游社联系客服页面
webview_gacha 游戏抽卡记录

JSON返回：

根对象：

字段 类型 内容 备注
retcode num 返回码
1002 请求体中有字段不正确
1016 游戏账号未绑定Cookie对应的账号
message str 返回消息
data obj Auth Key B

data对象：

字段 类型 内容 备注
sign_type num 2
authkey_ver num 1
authkey str Auth Key B
查看示例 
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "sign_type": 2,
    "authkey_ver": 1,
    "authkey": "***"
  }
}

国际服：

未知