mihoyo-api-collect/other/authentication.md

鉴权

部分API需要使用Cookie鉴权。

米游社

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

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

• x-rpc-app_version：APP版本号，例如2.44.1。 国际版APP与国内版APP每个版本对应生成DS所用的salt也不一样。
• x-rpc-client_type：安卓APP为2或5，网页为4。
• 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需要验证，为/ys
• X-Requested-With：国内版APP则为com.mihoyo.hyperion，国际版APP则为com.mihoyo.hoyolab。
• Origin：与Referer字段的协议与主机名部分相同。
• Host：请求的网站的主机名。
• Referer：在哪个网页发起的请求。 一般情况下，国内版APP为 https://webstatic.mihoyo.com/ https://app.mihoyo.com等等。 国际版APP为 https://webstatic-sea.hoyolab.com。
• DS：见DS值。
• User-Agent：用户代理，为okhttp/4.9.3或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