米游社密码登录

UIGF-org大约 5 分钟

米游社密码登录

密码登录

密码登录

操作步骤

获取设备指纹信息，记录返回data对象的device_fp。
向服务器传入账号密码以获取登录信息，获取响应头中所有Set-Cookie。可获取的Cookie有：Account ID、MiHoYo id、LToken（V2）、特定Cookie Token。

获取设备指纹

国服：

请求方式：POST

https://public-data-api.mihoyo.com/device-fp/api/getFp

JSON请求：

字段	类型	内容	备注
device_id	str	设备ID
seed_id	str	一般为随机值
seed_time	str	当前的Unix时间戳
platform	str	设备平台 1 iOS 2 安卓 4 网页	不同的设备平台需要在`ext_fields`字段中填写的的内容不同
device_fp	str	设备指纹	在此处可随机生成
app_name	str	请求的应用标识符 bbs_cn 米游社
ext_fields	str	一些设备信息	为JSON字符串。若`platform`为`4`，则必须包含`userAgent`字段；若`platform`为`2`，则需要包含['cpuType', 'romCapacity', 'productName', 'romRemain', 'manufacturer', 'appMemory', 'hostname', 'screenSize', 'osVersion', 'aaid', 'vendor', 'accelerometer', 'buildTags', 'model', 'brand', 'oaid', 'hardware', 'deviceType', 'devId', 'serialNumber', 'buildTime', 'buildUser', 'ramCapacity', 'magnetometer', 'display', 'ramRemain', 'deviceInfo', 'gyroscope', 'vaid', 'buildType', 'sdkVersion', 'board']字段

查看示例

{
    "device_id": "2d356b22f39b708c",
    "seed_id": "d81de6f4-6aa3-4e5f-b8e8-6a4f98e15a76",
    "seed_time": "1692248006205",
    "platform": "2",
    "device_fp": "38d7efe8b7f79",
    "app_name": "bbs_cn",
    "ext_fields": "{
    \"cpuType\":\"arm64-v8a\",
    \"romCapacity\":\"512\",
    \"productName\":\"ishtar\",
    \"romRemain\":\"459\",
    \"manufacturer\":\"Xiaomi\",
    \"appMemory\":\"512\",
    \"hostname\":\"xiaomi.eu\",
    \"screenSize\":\"1440x3022\",
    \"osVersion\":\"13\",
    \"aaid\":\"a945fe0c-5f49-4481-9ee8-418e74508414\",
    \"vendor\":\"中国电信\",
    \"accelerometer\":\"0.061016977x0.8362915x9.826724\",
    \"buildTags\":\"release-keys\",
    \"model\":\"2304FPN6DC\",
    \"brand\":\"Xiaomi\",
    \"oaid\":\"67b292338ad57a24\",
    \"hardware\":\"qcom\",
    \"deviceType\":\"ishtar\",
    \"devId\":\"REL\",
    \"serialNumber\":\"unknown\",
    \"buildTime\":\"1690889245000\",
    \"buildUser\":\"builder\",
    \"ramCapacity\":\"229481\",
    \"magnetometer\":\"80.64375x-14.1x77.90625\",
    \"display\":\"TKQ1.221114.001 release-keys\",
    \"ramRemain\":\"110308\",
    \"deviceInfo\":\"Xiaomi/ishtar/ishtar:13/TKQ1.221114.001/V14.0.17.0.TMACNXM:user/release-keys\",
    \"gyroscope\":\"7.9894776E-4x-1.3315796E-4x6.6578976E-4\",
    \"vaid\":\"4c10d338150078d8\",
    \"buildType\":\"user\",
    \"sdkVersion\":\"33\",
    \"board\":\"kalama\"
  }",
    "bbs_device_id": "b66a6178-f56d-30ed-97aa-297560c98fc1"
}

JSON返回：

根对象：

字段	类型	内容
retcode	num	返回码 -502 传入的内容有误
message	str	返回消息
data	obj	设备指纹

data对象：

字段	类型	内容
device_fp	str	设备指纹
code	num	返回码
msg	str	错误消息

查看示例

{
  "message": "OK",
  "retcode": 0,
  "data": {
    "code": 200,
    "device_fp": "ui33vcedffou",
    "msg": "ok"
  }
}

获取登录信息

国服：

请求方式：POST

需要验证请求头
x-rpc-app_id：bll8iq97cem8
x-rpc-client_type：2
x-rpc-game_biz：bbs_cn
x-rpc-device_fp：刚获取的设备指纹
x-rpc-device_id：与上个步骤传递的设备ID相同

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

JSON请求：

字段	类型	内容	备注
account	str	将登录账户的绑定邮箱或绑定手机	使用RSA + Base64加密，加密方式详见该页面
password	str	将登录账户的密码	使用RSA + Base64加密，加密方式详见该页面

JSON返回：

根对象：

字段	类型	内容	备注
retcode	num	返回码	-3235新设备登录(需手机短信验证)
message	str	返回消息
data	obj	账号信息

data对象：

字段	类型	内容	备注
login_ticket	str	Login Ticket	在一些情况下没有该字段
need_realperson	str	是否要求用户进行实名认证
token	obj	该账户的SToken（V2）	在一些情况下没有该字段
user_info	obj	用户信息
reactivate_info	obj	待调查
realname_info	obj	待调查

data对象→user_info对象：

字段	类型	内容	备注
account_name	str	账号名称	总是为空字符串
aid	str	Account ID
area_code	str	账号所绑定的电话号码对应的国家区号
country	str	国家	总是为空字符串
email	str	账号所绑定的邮箱
identity_code	str	账号的实名认证身份证号
is_email_verify	str	邮箱是否通过认证 1 已认证 0 未认证
links	str	第三方绑定信息
mid	str	MiHoYo ID
mobile	str	账号的绑定手机
realname	str	账号的实名认证姓名

data对象→token对象：

字段	类型	内容	备注
token_type	num	1
token	str	SToken（V2）

查看示例

{
  "data": {
    "login_ticket": "***",
    "need_realperson": false,
    "reactivate_info": {
      "required": false,
      "ticket": ""
    },
    "realname_info": {
      "action_ticket": "",
      "action_type": "",
      "required": false
    },
    "token": {
      "token": "***",
      "token_type": 1
    },
    "user_info": {
      "account_name": "",
      "aid": "311526738",
      "area_code": "+86",
      "country": "",
      "email": "**********",
      "identity_code": "******************",
      "is_email_verify": 1,
      "links": [
        {
          "email": "",
          "nickname": "***",
          "subType": "",
          "thirdparty": "tp",
          "union_id": "***"
        }
      ],
      "mid": "******",
      "mobile": "***********",
      "realname": "***",
      "rebind_area_code": "",
      "rebind_mobile": "",
      "rebind_mobile_time": "0",
      "safe_area_code": "",
      "safe_mobile": ""
    }
  },
  "message": "OK",
  "retcode": 0
}

新设备登录验证

国服：

前提->获取登录信息接口响应头(在recode返回-3235时)：

x-rpc-verify:

{
  "action_ticket":"106ffc83feb64f5f9bfa9e0dd1c91dca",
  "verify_str":
    {
      "ticket":"23123433c12e1bf40f2a76bb2",
      "verify_type":"2"
    }
}

字段	类型	内容	备注
action_ticket	str	设备通过后用于请求获取用户登录信息

verify_str根对象

字段	类型	内容	备注
ticket	str	用户验证标识符
verify_type	str	验证类型

查看示例

// 响应头
// x-rpc-verify
{
  "action_ticket": "106ffc83f123asdzfa9e0dd1c91dca",
  "verify_str": "{\"ticket\":\"23123433c12e1bf40f2a76bb2\",\"verify_type\":\"2\"}"
}


// 响应体：
{
  "data": null,
  "message": "您正在新设备上登录，为保障您的账号安全，请先使用手机短信验证身份",
  "retcode": -3235
}

请求方式：POST

需要验证请求头
x-rpc-app_id：bll8iq97cem8
x-rpc-client_type：2
x-rpc-game_biz：bbs_cn
x-rpc-device_fp：刚获取的设备指纹
x-rpc-device_id：与上个步骤传递的设备ID相同

https://passport-api.mihoyo.com/account/ma-cn-verifier/verifier/createMobileCaptchaByActionTicket

JSON请求：

字段	类型	内容	备注
action_ticket	str	登录信息响应体中的ticket
action_type	str	操作	此处为verify_for_component

查看示例

{
  "action_ticket":"fbca6ce757964296be7b0d0a3c558c5c",
  "action_type":"verify_for_component"
}

JSON返回：

字段	类型	内容	备注
retcode	num	返回码	为-3101触发人机验证
message	str	返回信息

查看示例

{
  "retcode":0,
  "message":"OK",
  "data":{}
}

触发人机验证：

响应头
参考极验文档

x-rpc-aigis:

{
  "session_id":"12131231231aa028d9c",
  "mmt_type":1,
  "data":
        {
          "success":1,
          "gt":"123123123123123b162892",
          "challenge":"123123123123ea064ed3a76",
          "new_captcha":1
        }
}

设备验证请求

请求方式：POST

https://passport-api.mihoyo.com/account/ma-cn-verifier/verifier/verifyActionTicketPartly

json请求

字段	类型	内容	备注
action_ticket	str	响应体下verify_str的ticket参数
action_type	str	操作	此处为verify_for_component
verify_method	num	验证模式	此处参考米游社为1
mobile_captcha	str	设备接收到的验证码

查看示例

{
  "action_ticket":"23123433c12e1bf40f2a76bb2",
  "action_type":"verify_for_component",
  "verify_method":1,
  "mobile_captcha":"980243"
}

JSON返回：

字段	类型	内容	备注
retcode	num	返回码
message	str	返回信息

查看示例

{
  "retcode":0,
  "message":"OK",
  "data":{}
}

通过Ticket获取登录信息

请求方式：POST

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

json请求

字段	类型	内容	备注
action_ticket	str	响应体下的action_ticket

查看示例

{
  "action_ticket":"106ffc83f123asdzfa9e0dd1c91dca"
}

JSON返回：

与获取登录信息一致