米游社/HoYoLab查询接口 – Heartalborada's Blog

2022/5/25更新: 新增了米游社获取mmt以及登录api

米游社

请求头

请求头名	说明	可能的值
x-rpc-app_version	米游社版本号	2.11.1
x-rpc-client_type	客户端类型(IOS/Android)	5
Cookie	米游社Cookie，可以通过电脑登录米游社获取	any
DS	生成方式如下
Referer	Referer	https://webstatic.mihoyo.com/
User-Agent	Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) miHoYoBBS/2.11.1)

DS加密方式

#python实现
def generate_cn_ds(body: Any = None, query: Mapping[str, Any] = None) -> str:
    '''
    Body: POST请求
    query: GET请求
    '''
    t = int(time.time())
    r = random.randint(100001, 200000)
    b = json.dumps(body) if body else 
    q = &.join(f{k}={v} for k, v in sorted(query.items())) if query else 
    h = hashlib.md5(fsalt={CN_DS_SALT}&t={t}&r={r}&b={b}&q={q}.encode()).hexdigest()
    return f{t},{r},{h}

API

米游社ID查询玩家信息

GET https://api-takumi-record.mihoyo.com/game_record/app/card/wapi/getGameRecordCard

传入字段	说明	值
uid	米游社ID	any

UID查询玩家基本信息

GET https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/index

传入字段	说明	值
role_id	玩家UID	any
server	玩家所在服务器	cn_gf01/cn_qd01

获取角色武器和圣遗物

POST https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/character

传入字段	说明	值
role_id	玩家UID	any
server	玩家所在服务器	cn_gf01/cn_qd01

获取当期和上期深渊数据

GET https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/spiralAbyss

传入字段	说明	值
role_id	玩家UID	any
server	玩家所在服务器	cn_gf01/cn_qd01
schedule_type	请求类型	1为当期，2为上期

获取mmt

GET https://webapi.account.mihoyo.com/Api/create_mmt

传入字段	说明	值
scene_type	未知	1
now	时间戳	当前时间戳
t	时间戳	当前时间戳
reason	来源地址	可以填“user.mihoyo.com%23%2Flogin%2Fcaptcha”

传入数据注意: 返回数据下的data.mmt_data有极验challenge、gt和mmt_key, 在下文的的登陆中需要，但是不需要生成DS

登录米游社

POST https://api-takumi.mihoyo.com/account/auth/api/webLoginByPassword

传入字段	说明	值
account	账号	any
password	密码	RSA加密后密码
mmt_key	mmt_key	mmt_key
is_bh2	是否为崩坏2	false
is_crypto	是否加密	true
geetest_challenge	极验challenge	极验challenge
geetest_validate	极验validate	极验validate
geetest_seccode	极验seccode	geetest_validate+
token_type	未知	填‘6’

RSA公钥

-----BEGIN PUBLIC KEY-----\nMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDvekdPMHN3AYhm/vktJT+YJr7\ncI5DcsNKqdsx5DZX0gDuWFuIjzdwButrIYPNmRJ1G8ybDIF7oDW2eEpm5sMbL9zs\n9ExXCdvqrn51qELbqj0XxtMTIpaCHFSI50PfPpTFV9Xt/hmyVwokoOXFlAEgCn+Q\nCgGs52bFoYMtyi+xEQIDAQAB\n-----END PUBLIC KEY-----

登录完成后便会设置cookie，返回值内有该账户信息

HoYoLab

请求头

请求头名	说明	可能的值
x-rpc-app_version	HoYoLab版本号	1.5.0
x-rpc-client_type	客户端类型(IOS/Android)	4
Cookie	米游社Cookie，可以通过电脑登录HoYoLab获取	any
DS	生成方式如下
Referer	Referer	https://webstatic-sea.mihoyo.com/
User-Agent	Mozilla/5.0 (X11; Linux x86_64; rv:89.0) Gecko/20100101 Firefox/89.0

请求头#### DS加密方式

def generate_ds() -> str:
    t = int(time.time())
    r = .join(random.choices(string.ascii_letters, k=6))
    h = hashlib.md5(fsalt={OS_DS_SALT}&t={t}&r={r}.encode()).hexdigest()
    return f{t},{r},{h}

API

HoYoLab ID查询玩家信息

GET https://bbs-api-os.hoyolab.com/game_record/card/wapi/getGameRecordCard

传入字段	说明	值
uid	米游社ID	any

UID查询玩家基本信息

GET https://bbs-api-os.hoyolab.com/game_record/genshin/api/index

传入字段	说明	值
role_id	玩家UID	any
server	玩家所在服务器	os_asia/os_euro/os_usa/os_cht

获取角色武器和圣遗物

POST https://bbs-api-os.hoyolab.com/game_record/genshin/api/character

传入字段	说明	值
role_id	玩家UID	any
server	玩家所在服务器	os_asia/os_euro/os_usa/os_cht

获取当期和上期深渊数据

GET https://bbs-api-os.hoyolab.com/game_record/genshin/api/spiralAbyss

传入字段	说明	值
role_id	玩家UID	any
server	玩家所在服务器	os_asia/os_euro/os_usa/os_cht
schedule_type	请求类型	1为当期，2为上期

它可以干什么呢?

~~它可以用来做反云玩家的小工具~~

像我，拿清明节三天假期做了个这个

exe打包下载: https://pan.loliurl.club/s/LPHR

[github author="heartalborada-del" project="genshin-player-query"][/github]

又或是这个

查看评论 - 17 条评论

Comments 17 条评论

博主 Zero

回复

发布于 2025-02-12 11:07 ( Edge 132 Windows 10/11 )( ) 来自: 中国河北省廊坊市

话说极验验证你们有什么头猪吗== =
- 博主 heartalborada
  
  回复
  
  发布于 2025-02-12 18:48 ( Edge 133 Windows 10/11 )( ) 来自: 中国广东广州市
  
  @Zero 我之前写的项目是直接调用极验的api进行验证，可以参考这个 kuresaru/geetest-validator
博主 Turmiht

回复

发布于 2023-05-13 22:37 ( Edge 113 macOS X Catalina 10.15 )( ) 来自: 澳大利亚 Victoria 墨尔本

想问一下这些盐值都是怎么获取的呀必须要解包客户端吗
- 博主 heartalborada
  
  回复
  
  发布于 2023-05-13 22:39 ( Edge 113 Windows 10/11 )( ) 来自: 日本 Tokyo 东京
  
  @Turmiht ~~其实是我翻其他大佬的开源项目看到的(~~
  应该是要解包客户端
博主 leshenyyds

回复

发布于 2023-05-10 02:50 ( Edge 108 Windows 10/11 )( ) 来自: 英国英格兰伦敦

为什么我gethttps://api-takumi-record.mihoyo.com/game_record/app/genshin/api/index东西也传了还是获取不了
- 博主 heartalborada
  
  回复
  
  发布于 2023-05-10 13:12 ( Edge 113 Windows 10/11 )( ) 来自: 英国英格兰伦敦
  
  @leshenyyds GET是获取方式，而且米哈游之前修改了API，我还没抓新的包
博主 66怪

回复

发布于 2023-04-23 18:20 ( Chrome 112 Windows 10/11 )( ) 来自: 新加坡 North West 新加坡

点赞
博主 Darker

回复

发布于 2022-09-25 13:45 ( Edge 105 Windows 10/11 )( ) 来自: 美国华盛顿州 Seattle

https://api.lelaer.com/ys/getPlayerRecord.php?uid=,提瓦特小助手的接口
- 博主 heartalborada
  
  回复
  
  发布于 2022-10-06 16:13 ( Edge 105 Windows 10/11 )( ) 来自: 美国加州 San Jose
  
  @Darker 其实吧，自己能写的部分还是自己写，mihoyo登录api都可以抓出来的
- 博主 leshenyyds
  
  回复
  
  发布于 2023-05-10 03:06 ( Edge 108 Windows 10/11 )( ) 来自: 英国英格兰伦敦
  
  @Darker 还有提瓦特别的接口吗
博主拾月上寻

回复

发布于 2022-08-19 21:46 ( Edge 104 Windows 10/11 )( ) 来自: 美国华盛顿州 Seattle

DS算法好像运行不了啊，会报语法错误
- 博主 heartalborada
  
  回复
  
  发布于 2022-08-20 21:30 ( Safari 604 iOS 15 )( ) 来自: 美国加州 San Jose
  
  @拾月上寻缺了个 DS_SALT
  OS_DS_SALT = “6cqshh5dhw73bzxn20oexa9k516chk7s”
  CN_DS_SALT = “xV8v4Qu54lUKrEYFZkJhB8cuOh9Asafs”
博主匿名

回复

发布于 2022-08-16 12:15 ( Edge 104 Linux )( ) 来自: 香港 Central and Western District Central

请问OS_DS_SALT是什么？
- 博主 heartalborada
  
  回复
  
  发布于 2022-08-16 13:03 ( Edge 104 Windows 10/11 )( ) 来自: 美国加州 San Jose
  
  @匿名国际服的MD5盐值
- 博主 heartalborada
  
  回复
  
  发布于 2022-08-16 13:06 ( Edge 104 Windows 10/11 )( ) 来自: 美国加州 San Jose
  
  @匿名坏了我没给（）
  OS_DS_SALT = “6cqshh5dhw73bzxn20oexa9k516chk7s”
  CN_DS_SALT = “xV8v4Qu54lUKrEYFZkJhB8cuOh9Asafs”
博主 kanokano

回复

发布于 2022-04-25 20:16 ( Edge 100 Windows 10/11 )( ) 来自: 中国天津市天津

这个实用！有空就整一个!|´・ω・)ノ
- 博主 heartalborada
  
  回复
  
  发布于 2022-07-14 11:58 ( Safari 605 macOS X Catalina 10.15 )( ) 来自: 美国加州洛杉矶
  
  @kanokano 实现api查询的后端挺简单的，唯一困难的就是前端的开发