mihoyo-api-collect/other/authentication.md

鉴权

• 请求头
  • 米游社
• Cookie

---

大多数API需要验证请求头。

部分API（例如点赞文章、《原神》米游社签到、米游币等）需要使用Cookie鉴权。

请求头

米游社

大多数API需要验证的请求头：x-rpc-app_version、x-rpc-client_type、x-rpc-device_id、X-Requested-With、Origin、Referer、Host、DS、User-Agent。

少数API才需要验证的额外的请求头：x-rpc-page、x-rpc-challenge。

可选请求头：x-rpc-device_fp、x-rpc-device_name、x-rpc-device_model、x-rpc-sys_version、x-rpc-channel。

x-rpc-app_version

x-rpc-app_version

米游社版本号，例如2.44.1。

与DS字段相关，DS生成需要salt，而每个米游社版本的salt都不同。

因此1个米游社版本只能使用对应的1个salt用于生成DS。

x-rpc-client_type

APP为2或5，网页为4。

根据请求的API不同而变化。

将会在需要验证请求头的API进行标注。

与DS字段相关，DS生成需要salt，而不同的x-rpc-client_type对应该版本米游社的salt也不同。

• x-rpc-sys_version（可选）：安卓系统大版本版本号，例如Android 13则为13。
• x-rpc-channel（可选）：手机厂商，例如小米则为xiaomi。
• x-rpc-device_name（可选）：手机厂商和手机型号，例如小米11青春版则为Xiaomi M2101K9C。
• x-rpc-device_model（可选）：手机型号。

x-rpc-page

少数API需要验证，未知其规律。

3.1.3_#/ys

X-Requested-With

国内版APP为com.mihoyo.hyperion。

国际版APP为com.mihoyo.hoyolab。

Origin

请求网站的协议与主机名。

Host

请求的网站的主机名。

Referer

在哪个网页发起的请求。

一般情况下，国内版APP为

若x-rpc-client_type为5，则https://webstatic.mihoyo.com/

若x-rpc-client_type为2，则https://app.mihoyo.com

国际版APP为

https://webstatic-sea.hoyolab.com。

User-Agent

无需验证请求头或x-rpc-client_type为2的API不需要设置请求头。

但还是最好避免带有python等字样。

用户代理，为Mozilla/5.0 (Linux; Android 13; M2101K9C Build/TKQ1.220829.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/108.0.5359.128 Mobile Safari/537.36 miHoYoBBS/米游社版本号。

DS

DS值通过一系列算法得出。

Cookie