mihoyo-api-collect/hoyolab/user/token.md

用户Token

• Token
  • 通过Login Ticket获取SToken和LToken
  • 通过SToken获取Cookie Token
  • 通过Game Token获取SToken
  • 通过Game Token获取Cookie Token
  • 通过Cookie Token获取Hk4e Token
• Auth Key
  • 通过SToken获取用户Auth Key A
  • 通过SToken获取用户Auth Key B

---

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": "317832114",
    "cookie_token": "O4ljtFwozX0UzHg29PDffnEBQPMYxmzcEJpe5Fgz"
  }
}

通过Cookie Token获取Hk4e Token

国服：

请求方式：POST

需要验证Cookie

Account ID：account_id

Cookie Token：cookie_token

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

参数：

字段	类型	内容	备注
account_id	num	对应的米游社账号UID

JSON返回：

根对象：

查看示例

{
  "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 请求体的game_biz字段不正确
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：2

LKsalt

DS1

需要验证Cookie

SToken

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

JSON请求：

字段	类型	内容	备注
game_biz	str	获取的authkeyB的游戏 hk4e_cn 《原神》国服 hkrpg_cn 《崩坏：星穹铁道》国服
game_uid	num	用户的游戏UID

JSON返回：

根对象：

字段	类型	内容	备注
retcode	num	返回码 1002 请求体的game_biz字段不正确
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": "***"
  }
}

国际服：

未知