跳至主要內容

用户Token

UIGF-org大约 8 分钟

用户Token

Token

通过Login Ticket获取LToken（V1）

现在该接口只返回 ltoken，详见 #46

国服：

请求方式：GET

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

参数：

字段类型内容备注
token_typesnum获取的Token的类型
1 仅SToken 已弃用
2 仅LToken
3 SToken和LToken 仅LToken
4 无
login_ticketstr有效的Login Ticket
uidnum对应的米游社账号UID

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobjToken

data对象：

字段类型内容备注
listarrSToken或LToken

data对象→list数组→对象：

字段类型内容备注
namestrToken类型
ltoken LToken
stoken SToken
tokenstrToken值
查看示例
{
  "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

参数：

字段类型内容备注
stokenstr有效的SToken
uidnum对应的米游社账号UID

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobjCookie Token和米游社UID

data对象：

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

通过Game Token获取SToken（V1）

国服：

请求方式：POST

需要验证请求头

x-rpc-app_id

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

JSON请求：

字段类型内容备注
account_idnum对应的米游社账号UID
game_tokenstr有效的Game Token

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
-3005 未传递x-rpc-app_id请求头
messagestr返回消息
dataobj账号的Token与隐私信息

data对象：

字段类型内容备注
tokenobj米游社账号的SToken
user_infoobj米游社账号敏感信息一些个人信息已被隐藏
realname_info待调查
need_realpersonbool待调查

data对象→token对象：

字段类型内容备注
token_typenum1
tokenstr账号的SToken

data对象→user_info对象：

字段类型内容备注
aidstr米游社账号UID
midstr米游社MiHoYo ID
account_namestr空字符串
emailstr被隐藏的账号的绑定邮箱
is_email_verifynum绑定邮箱是否通过验证
area_codestr账号绑定手机的国家号码
mobilestr被隐藏的账号的绑定手机
safe_area_codestr账号安全手机的国家号码历史遗留字段，现在安全手机的功能已经被移除了
safe_mobilestr被隐藏的账号安全手机历史遗留字段，现在安全手机的功能已经被移除了
realnamestr被隐藏的账号实名认证姓名
identity_codestr被隐藏的账号实名认证身份证号
rebind_area_codestr账号的换绑手机号的国家号码
rebind_mobilestr被隐藏的账号的换绑手机号
rebind_mobile_timestr0
linksarr待调查
查看示例
{
  "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_idnum对应的米游社账号UID
game_tokenstr有效的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请求：

字段类型内容备注
regionstr《原神》账号对应的服务器名称
uidstrCookie对应米游社账号已绑定的《原神》账号的UID
game_bizstrhk4e_cn

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
-1002 游戏账号未绑定Cookie对应的账号
messagestr返回消息
dataobj《原神》账号的基础信息

data对象：

字段类型内容备注
gamestrhk4e
regionstr《原神》账号对应的服务器的名称
game_uidstr《原神》账号的UID
game_bizstrhk4e_cn
levelnum《原神》账号的冒险等级
nicknamestr《原神》账号昵称
region_namestr《原神》账号对应服务器的称呼
查看示例
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "game": "hk4e",
    "region": "cn_gf01",
    "game_uid": "222681079",
    "game_biz": "hk4e_cn",
    "level": 58,
    "nickname": "※青衫入雨※",
    "region_name": "天空岛"
  }
}

通过SToken（V1）获取SToken（V2）

国服：

请求方式：POST

需要验证请求头

x-rpc-app_id：bll8iq97cem8

需要验证Cookie

SToken

https://passport-api.mihoyo.com/account/ma-cn-session/app/getTokenBySToken

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj该账号的SToken（V2）与部分账号个人信息个人信息已隐藏

data对象：

字段类型内容备注
tokenobj该账号的SToken（V2）
user_infoobj部分账号个人信息个人信息已隐藏
need_realpersonbool待调查
realname_info待调查

data对象→token对象：

字段类型内容备注
token_typenum1
tokenstr该账号的SToken（V2）
查看示例
{
  "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
  }
}

通过SToken获取LToken（V1）

国服：

请求方式：GET

需要验证Cookie

SToken

https://passport-api.mihoyo.com/account/auth/api/getLTokenBySToken

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj该账号的LToken（V1）

data对象：

字段类型内容备注
ltokenstr该账号的LToken（V1）
查看示例
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "ltoken": "******"
  }
}

通过SToken获取Game Token

国服：

请求方式：GET

需要验证Cookie

SToken

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

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj该账号的Game Token

data对象：

字段类型内容备注
game_tokenstr该账号的Game Token
查看示例
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "game_token": "******"
  }
}

Action Ticket

通过SToken获取Action Ticket

国服：

请求方式：GET

需要验证Cookie

SToken

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

参数：

字段类型内容备注
action_typestr获取Action Ticket的用途
game_role 获取绑定游戏账号信息

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj对应用途的Action Ticket与部分账号个人信息个人信息已隐藏

data对象：

字段类型内容备注
ticketstrAction Ticket
is_verifiedbool待调查
account_infoobj部分个人信息个人信息已隐藏

data对象→account_info对象：

字段类型内容备注
is_realnamebool待调查
mobilestr绑定手机的手机号
safe_mobilestr安全手机的手机号历史遗留字段，现在安全手机的功能已经被移除了
safe_area_codestr安全手机的国家号码历史遗留字段，现在安全手机的功能已经被移除了
account_idstrCookie对应米游社账号的ID
account_namestr空字符串
emailstr被隐藏的绑定邮箱
is_email_verifybool绑定邮箱是否已通过验证
area_codestr绑定手机的国家号码
real_namestr被隐藏的实名认证中的姓名
identify_codestr被隐藏的实名认证中的身份证号
create_timestr该米游社账号创建时间的Unix时间戳
create_ipstr待调查
change_pwd_timesr待调查
nicknamestr空字符串
user_icon_idnum待调查
safe_levelnum该账号的安全等级
3 高
black_endtimestr待调查
black_notestr待调查
gendernum性别
real_statnum待调查
apple_namestr待调查
sony_namestr待调查
tap_namestr待调查
reactivate_ticketstr待调查
查看示例
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "ticket": "***",
    "is_verified": false,
    "account_info": {
      "is_realname": false,
      "mobile": "***********",
      "safe_mobile": "",
      "account_id": "317832114",
      "account_name": "",
      "email": "262****725@qq.com",
      "is_email_verify": true,
      "area_code": "+86",
      "safe_area_code": "",
      "real_name": "***",
      "identity_code": "******************",
      "create_time": "1646740732",
      "create_ip": "",
      "change_pwd_time": "0",
      "nickname": "",
      "user_icon_id": 0,
      "safe_level": 3,
      "black_endtime": "0",
      "black_note": "",
      "gender": 0,
      "real_stat": 0,
      "apple_name": "",
      "sony_name": "",
      "tap_name": "",
      "reactivate_ticket": ""
    }
  }
}

国际服：

未知

Auth Key

通过SToken获取账号Auth Key A

国服：

请求方式：POST

需要验证Cookie

SToken

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

JSON请求：

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

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
1002 请求体中有字段不正确
messagestr返回消息
dataobjAuth Key A

data对象：

字段类型内容备注
sign_typenum2
authkey_vernum1
authkeystrAuth 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_bizstr获取的Auth Key B的游戏
hk4e_cn 《原神》国服
hkrpg_cn 《崩坏：星穹铁道》国服
game_uidnum用户的游戏UID
regionstr用户游戏ID对应的服务器的名称
auth_appidstr获取的Auth Key B的类型
im_ccs 米游社
csc 米游社联系客服页面
webview_gacha 游戏抽卡记录

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
1002 请求体中有字段不正确
1016 游戏账号未绑定Cookie对应的账号
messagestr返回消息
dataobjAuth Key B

data对象：

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

国际服：

未知

统一可交换原神数据标准
Copyright © 2024 UIGF-org