游戏账号信息
游戏账号信息
获取游戏记录卡片信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:2
K2
salt
DS1
需要验证Cookie
SToken
https://api-takumi-record.mihoyo.com/game_record/card/api/getGameRecordCard
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
uid | str | 想要获取游戏记录卡片信息的米游社账号ID |
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | 该米游社账号的所有游戏记录卡片信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
list | arr | 所有游戏记录卡片信息 |
data
对象→list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
has_role | bool | 该账号是否已绑定该游戏的任何账号 | |
game_id | num | 该游戏记录对应的游戏ID | |
game_role_id | str | 该游戏记录展示的游戏账号ID | |
nickname | str | 该游戏账号的昵称 | |
region | str | 该游戏账号所属服务器的名称 | |
level | num | 该游戏账号的等级 | 例如原神的冒险等级 |
background_image | str | 该游戏记录卡片背景图片的URL | |
is_public | bool | 该账号是否公开该游戏记录 | |
data | arr | 该游戏记录的一些简略信息 | |
region_name | str | 该游戏账号所属服务器的称呼 | |
url | str | 该游戏记录卡片将跳转页面的URL | |
data_switches | arr | 待调查 | |
h5_data_switches | arr | 待调查 | |
background_color | str | 该卡片背景颜色的16进制颜色值 |
data
对象→list
数组→对象→data
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
name | str | 该记录项的名称 | |
type | num | 待调查 | |
value | str | 该记录项的数据 |
data
对象→list
数组→对象→data_switches
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
switch_id | str | 待调查 | |
is_public | bool | 待调查 | |
switch_name | str | 待调查 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"list": [
{
"has_role": true,
"game_id": 2,
"game_role_id": "222681079",
"nickname": "※青衫入雨※",
"region": "cn_gf01",
"level": 59,
"background_image": "https://upload-bbs.mihoyo.com/upload/2020/09/22/0762ab7cc42ac5a760bb4d1ea87b2c42_1236712390449986860.png",
"is_public": true,
"data": [
{
"name": "活跃天数",
"type": 1,
"value": "524"
},
{
"name": "获得角色数",
"type": 1,
"value": "53"
},
{
"name": "成就达成数",
"type": 1,
"value": "795"
},
{
"name": "深境螺旋",
"type": 1,
"value": "8-3"
}
],
"region_name": "天空岛",
"url": "https://webstatic.mihoyo.com/app/community-game-records/?bbs_presentation_style=fullscreen&bbs_auth_required=true&v=101&gid=2&user_id=317832114",
"data_switches": [
{
"switch_id": 1,
"is_public": true,
"switch_name": "个人主页卡片"
},
{
"switch_id": 2,
"is_public": true,
"switch_name": "角色详情数据"
}
],
"h5_data_switches": [],
"background_color": "D3BC8E"
},
...
]
}
}
通过LToken获取绑定游戏账号的基本信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://api-takumi.mihoyo.com/binding/api/getUserGameRolesByCookie
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
game_biz | str | 游戏标识符 | 若该值为空,将返回所有绑定游戏账号的信息 |
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | Cookie对应米游社账号绑定的游戏账号信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
list | arr | 游戏账号基本信息 |
data
对象→list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
game_biz | str | 该游戏账号所属游戏的标识符 | |
region | str | 该游戏账号所在服务器的名称 | |
game_uid | str | 该游戏账号的UID | |
nickname | str | 该游戏账号的昵称 | |
level | num | 该游戏账号的等级 | |
is_chosen | bool | 是否已收藏该游戏账号 | |
region_name | str | 该游戏账号所在服务器的称呼 | |
is_official | bool | 该游戏账号所在服务器是否为官方服务器 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"list": [
{
"game_biz": "hk4e_cn",
"region": "cn_qd01",
"game_uid": "524923864",
"nickname": "༽墨ᐒ染ᐓ月༼",
"level": 22,
"is_chosen": false,
"region_name": "世界树",
"is_official": false
},
...
]
}
}
通过SToken获取绑定游戏账号的基本信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:2
K2
salt
DS1
需要验证Cookie
SToken
https://api-takumi.miyoushe.com/binding/api/getUserGameRolesByStoken
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | Cookie对应米游社账号绑定的游戏账号信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
list | arr | 游戏账号基本信息 |
data
对象→list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
game_biz | str | 该游戏账号所属游戏的标识符 | |
region | str | 该游戏账号所在服务器的名称 | |
game_uid | str | 该游戏账号的UID | |
nickname | str | 该游戏账号的昵称 | |
level | num | 该游戏账号的等级 | |
is_chosen | bool | 是否已收藏该游戏账号 | |
region_name | str | 该游戏账号所在服务器的称呼 | |
is_official | bool | 该游戏账号所在服务器是否为官方服务器 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"list": [
{
"game_biz": "hk4e_cn",
"region": "cn_qd01",
"game_uid": "524923864",
"nickname": "༽墨ᐒ染ᐓ月༼",
"level": 22,
"is_chosen": false,
"region_name": "世界树",
"is_official": false
},
...
]
}
}
通过Action Ticket获取绑定游戏账号的基本信息
国服:
请求方式:GET
https://api-takumi.miyoushe.com/binding/api/getUserGameRoles
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
action_ticket | str | 用于获取绑定游戏账号信息的有效Action Ticket | |
game_biz | str | 游戏标识符 | 若该值为空,将返回所有绑定游戏账号的信息 |
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | Cookie对应米游社账号绑定的游戏账号信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
list | arr | 游戏账号基本信息 |
data
对象→list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
game_biz | str | 该游戏账号所属游戏的标识符 | |
region | str | 该游戏账号所在服务器的名称 | |
game_uid | str | 该游戏账号的UID | |
nickname | str | 该游戏账号的昵称 | |
level | num | 该游戏账号的等级 | |
is_chosen | bool | 是否已收藏该游戏账号 | |
region_name | str | 该游戏账号所在服务器的称呼 | |
is_official | bool | 该游戏账号所在服务器是否为官方服务器 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"list": [
{
"game_biz": "hk4e_cn",
"region": "cn_qd01",
"game_uid": "524923864",
"nickname": "༽墨ᐒ染ᐓ月༼",
"level": 22,
"is_chosen": false,
"region_name": "世界树",
"is_official": false
},
...
]
}
}
原神
获取首页信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/index
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
role_id | num | 原神UID | |
server | str | 服务器名称 |
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | 玩家信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
role | obj | 玩家基础信息 | |
avatars | arr | 玩家拥有的角色的信息 | 若Cookie对应的账号不是自己的,则只返回好感度最高的8个角色。 |
stats | obj | 玩家世界信息 | |
city_explorations | arr | 待调查 | 似乎没有用 |
world_explorations | arr | 玩家的世界探索信息 | |
homes | arr | 玩家的尘歌壶信息 |
data
对象→role
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
AvatarUrl | str | 玩家头像 | 总是为空字符串 |
nickname | str | 玩家昵称 | |
region | str | 玩家账号的服务器名称 | |
level | num | 玩家的冒险等级 |
data
对象→avatars
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该角色的ID | |
image | str | 该角色的头像 | |
element | str | 该角色的元素 | 英文 |
fetter | num | 该角色的好感度 | |
level | num | 该角色的等级 | |
rarity | num | 该角色的稀有度 | |
actived_constellation_num | num | 该角色的已激活命之座数量 | |
card_image | str | 该角色的角色卡 | |
is_chosen | bool | 是否收藏了该角色 |
data
对象→stats
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
active_day_number | num | 该玩家的游玩天数 | |
achievement_number | num | 该玩家已达成的成就数量 | |
anemoculus_number | num | 该玩家已供奉的风神瞳数量 | |
geoculus_number | num | 该玩家已供奉的岩神瞳数量 | |
avatar_number | num | 该玩家拥有的角色数量 | |
way_point_number | num | 该玩家已激活的传送锚点数量 | |
domain_number | num | 该玩家已激活的秘境入口数量 | |
spiral_abyss | num | 该玩家当前的深境螺旋层级 | |
precious_chest_number | num | 该玩家已开启的珍贵的宝箱数量 | |
luxurious_chest_number | num | 该玩家已开启的华丽的宝箱数量 | |
exquisite_chest_number | num | 该玩家已开启的精致的宝箱数量 | |
common_chest_number | num | 该玩家已开启的普通的宝箱数量 | |
electroculus_number | num | 该玩家已供奉的雷神瞳数量 | |
magic_chest_number | num | 该玩家已开启的奇馈宝箱数量 | |
dendroculus_number | num | 该玩家已供奉的草神瞳数量 |
data
对象→world_explorations
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
level | num | 地区声望等级 | |
exploration_percentage | num | 地区探索度 | 百分比×10,例如10%探索度则该字段为100 |
icon | str | 地区图标 | |
name | str | 地区名称 | |
type | str | Reputation 声望 | |
offerings | arr | 该地区除神像以外的等级信息,例如须弥的梦之树、稻妻的神樱树等 | |
id | num | 该地区的ID | |
parent_id | num | 父地区的ID | |
map_url | str | 该地区在米游社观测枢原神大地图的链接 | |
strategy_url | str | 该地区在米游社攻略的链接 | |
background_image | str | 该地区的背景图 | |
inner_icon | str | 该地区的图标 | |
cover | str | 该地区的覆盖图 |
data
对象→world_explorations
数组→对象→offerings
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
name | str | 名称 | |
level | num | 等级 | |
icon | str | 图标 |
data
对象→homes
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
level | num | 该玩家的尘歌壶等级 | |
visit_num | num | 该玩家的尘歌壶总造访人数 | |
comfort_num | num | 尘歌壶该岛的洞天仙力 | |
item_num | num | 该玩家的摆设图纸数量 | |
name | str | 尘歌壶该岛的名称 | |
icon | str | 尘歌壶该岛的图标 | |
comfort_level_name | str | 尘歌壶该岛的洞天仙力的称号 | |
comfort_level_icon | str | 尘歌壶该岛的洞天仙力的图标 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"role": {
"AvatarUrl": "",
"nickname": "※青衫入雨※",
"region": "cn_gf01",
"level": 57
},
"avatars": [
{
"id": 10000002,
"image": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"name": "神里绫华",
"element": "Cryo",
"fetter": 10,
"level": 90,
"rarity": 5,
"actived_constellation_num": 0,
"card_image": "https://upload-bbs.mihoyo.com/game_record/genshin/character_card_icon/UI_AvatarIcon_Ayaka_Card.png",
"is_chosen": false
},
...
],
"stats": {
"active_day_number": 340,
"achievement_number": 631,
"anemoculus_number": 66,
"geoculus_number": 130,
"avatar_number": 46,
"way_point_number": 285,
"domain_number": 46,
"spiral_abyss": "12-3",
"precious_chest_number": 290,
"luxurious_chest_number": 113,
"exquisite_chest_number": 965,
"common_chest_number": 1455,
"electroculus_number": 128,
"magic_chest_number": 80,
"dendroculus_number": 182
},
"city_explorations": [],
"world_explorations": [
{
"level": 5,
"exploration_percentage": 560,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/city_icon/UI_ChapterIcon_Xumi.png",
"name": "须弥",
"type": "Reputation",
"offerings": [
{
"name": "梦之树",
"level": 29,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/city_icon/UI_ChapterOffering_DreamTree.png"
}
],
"id": 8,
"parent_id": 0,
"map_url": "https://webstatic.mihoyo.com/ys/app/interactive-map/index.html?bbs_presentation_style=no_header&utm_source=mys&utm_medium=ys&utm_campaign=gamerecord&lang=zh-cn&_markerFps=24#/map/2?center=3116.00,-3823.00&zoom=-2.00&shown_types=",
"strategy_url": "https://bbs.mihoyo.com/ys/strategy/channel/map/45/251?bbs_presentation_style=no_header",
"background_image": "https://upload-bbs.mihoyo.com/game_record/genshin/city_icon/UI_ChapterBackground_Xumi.png",
"inner_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/city_icon/UI_ChapterInnerIcon_Xumi.png",
"cover": "https://upload-bbs.mihoyo.com/game_record/genshin/city_icon/UI_ChapterCover_Xumi.png"
},
...
],
"homes": [
{
"level": 8,
"visit_num": 3,
"comfort_num": 6500,
"item_num": 466,
"name": "罗浮洞",
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/home/UI_HomeworldModule_2_Pic.png",
"comfort_level_name": "初显锦绣",
"comfort_level_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/home/UI_Homeworld_Comfort_5.png"
},
...
]
}
}
国际服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://bbs-api-os.hoyolab.com/game_record/genshin/api/index
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
role_id | num | 原神UID | |
server | str | 服务器名称 |
获取游戏账号基本信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/roleBasicInfo
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
server | str | 服务器名称 | |
role_id | num | 原神UID |
JSON返回
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | 该游戏账号的基本信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
AvatarUrl | str | 空字符串 | |
nickname | str | 该游戏账号的昵称 | |
region | str | 该游戏账号所属服务器的名称 | |
level | num | 该游戏账号的冒险等级 | |
card_play_level | num | 待调查 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"AvatarUrl": "",
"nickname": "※青衫入雨※",
"region": "cn_gf01",
"level": 59,
"card_play_level": 0
}
}
获取实时便笺信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/dailyNote
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
server | str | 服务器名称 | |
role_id | num | 原神UID |
JSON返回
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | 该游戏账号的实时便笺信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
current_resin | num | 当前树脂 | |
max_resin | num | 树脂上限 | 恒为160 |
resin_recovery_time | str | 树脂恢复时间 | 以秒为单位 |
finished_task_num | num | 已完成任务数 | 为日常委托完成数 |
total_task_num | num | 总任务数 | 为日常委托总数 |
is_extra_task_reward_received | bool | 是否领取额外奖励 | |
remain_resin_discount_num | num | 剩余周本折扣次数 | |
resin_discount_num_limit | num | 周本折扣次数上限 | |
current_expedition_num | num | 当前探索次数 | |
max_expedition_num | num | 探索次数上限 | |
expeditions | arr | 探索队伍信息 | |
current_home_coin | num | 当前家园币 | |
max_home_coin | num | 家园币上限 | |
home_coin_recovery_time | str | 家园币恢复时间 | 以秒为单位 |
calendar_url | str | 日历链接 | |
transformer | obj | 转换器信息 | |
daily_task | obj | 日常任务信息 | |
archon_quest_progress | obj | 主线任务进度 |
data
对象→expeditions
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_side_icon | str | 角色头像 | |
status | str | 状态 | Ongoing-派遣中 Finished-完成 |
remained_time | str | 剩余时间 | 以秒为单位 |
data
对象→transformer
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
obtained | bool | 是否获得 | |
recovery_time | obj | 恢复时间 | |
wiki | str | 百科链接 | |
noticed | bool | 是否通知 | |
latest_job_id | str | 最新任务ID |
data
对象→transformer
对象→recovery_time
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
Day | num | 天数 | |
Hour | num | 小时 | |
Minute | num | 分钟 | |
Second | num | 秒数 | |
reached | bool | 是否到达 |
data
对象→daily_task
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
total_num | num | 总任务数 | |
finished_num | num | 已完成任务数 | |
is_extra_task_reward_received | bool | 是否领取额外奖励 | |
task_rewards | arr | 任务奖励 | |
attendance_rewards | arr | 签到奖励 | |
attendance_visible | bool | 是否显示签到 |
data
对象→daily_task
对象→task_rewards
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
status | str | 状态 |
task_rewards.status
枚举类型如下:
TaskRewardStatusInvalid
:无效TaskRewardStatusTakenAward
:已领取TaskRewardStatusUnfinished
:未完成TaskRewardStatusFinished
:已完成
data
对象→daily_task
对象→attendance_rewards
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
status | str | 状态 | |
progress | num | 进度 | 最大2000 |
attendance_rewards.status
枚举类型如下:
AttendanceRewardStatusInvalid
:无效AttendanceRewardStatusTakenAward
:已领取AttendanceRewardStatusWaitTaken
:等待领取AttendanceRewardStatusUnfinished
:未完成AttendanceRewardStatusFinishedNonReward
:已完成但无奖励AttendanceRewardStatusForbid
:禁止领取
data
对象→archon_quest_progress
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
list | arr | 任务列表 | |
is_open_archon_quest | bool | 是否开启主线任务 | |
is_finish_all_mainline | bool | 是否完成所有主线任务 | |
is_finish_all_interchapter | bool | 是否完成所有间章任务 | |
wiki_url | str | 百科链接 |
data
对象→archon_quest_progress
对象→list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 任务ID | |
chapter_title | str | 任务名称 | |
chapter_num | str | 任务章节 | |
status | str | 任务状态 |
archon_quest_progress.list.status
枚举类型如下:
StatusNotOpen
:未开启StatusOngoing
:进行中StatusFinished
:已完成
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"current_resin": 160,
"max_resin": 160,
"resin_recovery_time": "0",
"finished_task_num": 4,
"total_task_num": 4,
"is_extra_task_reward_received": true,
"remain_resin_discount_num": 3,
"resin_discount_num_limit": 3,
"current_expedition_num": 5,
"max_expedition_num": 5,
"expeditions": [
{
"avatar_side_icon": "https://act-webstatic.mihoyo.com/hk4e/e20200928calculate/item_avatar_side_icon_u1536f/d06041afad12e786feec4bd91af88c47.png",
"status": "Ongoing",
"remained_time": "50850"
},
{
"avatar_side_icon": "https://act-webstatic.mihoyo.com/hk4e/e20200928calculate/item_avatar_side_icon_u1536f/0a690548d7aa399313856434db3a43dc.png",
"status": "Ongoing",
"remained_time": "50850"
},
{
"avatar_side_icon": "https://act-webstatic.mihoyo.com/hk4e/e20200928calculate/item_avatar_side_icon_u1536f/a4f153a2f89c05b83943c3cc51346c41.png",
"status": "Ongoing",
"remained_time": "50850"
},
{
"avatar_side_icon": "https://act-webstatic.mihoyo.com/hk4e/e20200928calculate/item_avatar_side_icon_u1536f/2e2786b714207285c98e02f265dcc103.png",
"status": "Ongoing",
"remained_time": "1954"
},
{
"avatar_side_icon": "https://act-webstatic.mihoyo.com/hk4e/e20200928calculate/item_avatar_side_icon_u1536f/3fddceeb1aac42fb6077446a007915c4.png",
"status": "Ongoing",
"remained_time": "1954"
}
],
"current_home_coin": 0,
"max_home_coin": 2400,
"home_coin_recovery_time": "284857",
"calendar_url": "https://bbs.mihoyo.com/ys/obc/channel/map/193?bbs_presentation_style=no_header",
"transformer": {
"obtained": true,
"recovery_time": {
"Day": 0,
"Hour": 0,
"Minute": 0,
"Second": 0,
"reached": true
},
"wiki": "https://bbs.mihoyo.com/ys/obc/content/1562/detail?bbs_presentation_style=no_header",
"noticed": false,
"latest_job_id": "0"
},
"daily_task": {
"total_num": 4,
"finished_num": 4,
"is_extra_task_reward_received": true,
"task_rewards": [
{
"status": "TaskRewardStatusUnfinished"
},
{
"status": "TaskRewardStatusUnfinished"
},
{
"status": "TaskRewardStatusUnfinished"
},
{
"status": "TaskRewardStatusUnfinished"
}
],
"attendance_rewards": [
{
"status": "AttendanceRewardStatusTakenAward",
"progress": 2000
},
{
"status": "AttendanceRewardStatusTakenAward",
"progress": 2000
},
{
"status": "AttendanceRewardStatusTakenAward",
"progress": 2000
},
{
"status": "AttendanceRewardStatusTakenAward",
"progress": 2000
}
],
"attendance_visible": true
},
"archon_quest_progress": {
"list": [],
"is_open_archon_quest": true,
"is_finish_all_mainline": true,
"is_finish_all_interchapter": true,
"wiki_url": ""
}
}
}
获取角色信息
国服:
请求方式:POST
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/character
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
server | str | 服务器名称 | |
role_id | num | 原神UID |
JSON返回
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | 该游戏账号的角色信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatars | arr | 该账号拥有的角色的信息 | 若Cookie对应的账号不是自己的,则只返回好感度最高的8个角色。 |
role | obj | 该账号的基本信息 |
data
对象→avatars
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 角色ID | |
image | str | 角色的图像 | |
icon | str | 角色的图标 | |
name | str | 角色姓名 | |
element | str | 角色的元素 | 英文 |
fetter | num | 角色好感度 | |
level | num | 角色等级 | |
rarity | num | 角色稀有度 | |
weapon | obj | 角色持有武器的信息 | |
reliquaries | arr | 角色佩戴的圣遗物的信息 | |
constellations | arr | 角色的命之座信息 | |
actived_constellation_num | num | 该角色已点亮的命之座数量 | |
costumes | arr | 该账号拥有的该角色衣装信息 | |
external | 待调查 |
data
对象→avatars
数组→对象→weapon
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该武器ID | |
name | str | 该武器的名称 | |
icon | str | 该武器的图标 | |
type | num | 该武器的类型 | |
rarity | num | 该武器的稀有度 | |
level | num | 该武器的等级 | |
promote_level | num | 该武器的精炼等级 | |
type_name | str | 该武器所属类型的名称 | |
desc | str | 该武器的描述 | |
affix_level | num | 待调查 |
data
对象→avatars
数组→对象→reliquaries
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该圣遗物的ID | |
name | str | 该圣遗物的名称 | |
icon | str | 该圣遗物的图标 | |
pos | num | 该圣遗物的位置 1 生之花 2 死之羽 3 空之杯 4 时之沙 5 理之冠 | |
rarity | num | 该圣遗物的稀有度 | |
level | num | 该圣遗物的等级 | |
set | obj | 该圣遗物所属的圣遗物套装的信息 | |
pos_name | str | 该圣遗物的位置的名称 |
data
对象→avatars
数组→对象→reliquaries
数组→对象→set
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该圣遗物套装的ID | |
name | str | 该圣遗物套装的名称 | |
affixes | arr | 该圣遗物套装的套装效果信息 |
data
对象→avatars
数组→对象→reliquaries
数组→对象→set
对象→affixes
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
activation_number | num | 需要装备多少该套装内的圣遗物才能激活该效果 | |
effect | str | 该圣遗物套装效果的描述 |
data
对象→avatars
数组→对象→constellations
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该命之座的ID | |
name | str | 该命之座的名称 | |
icon | str | 该命之座的图标 | |
effect | str | 该命之座的描述 | |
is_actived | bool | 该账号是否已激活该命之座 | |
pos | num | 该命之座的位置 |
data
对象→avatars
数组→对象→costumes
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该衣装的ID | |
name | str | 该衣装的名称 | |
icon | str | 该衣装的图标 |
data
对象→role
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
AvatarUrl | str | 该账号的头像 | 似乎没有用 |
nickname | str | 该账号的昵称 | |
region | str | 该账号在的服务器的名称 | |
level | num | 该账号的冒险等级 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"avatars": [
{
"id": 10000002,
"image": "https://upload-bbs.mihoyo.com/game_record/genshin/character_image/UI_AvatarIcon_Ayaka@2x.png",
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"name": "神里绫华",
"element": "Cryo",
"fetter": 10,
"level": 90,
"rarity": 5,
"weapon": {
"id": 11505,
"name": "磐岩结绿",
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/equip/UI_EquipIcon_Sword_Morax.png",
"type": 1,
"rarity": 5,
"level": 90,
"promote_level": 6,
"type_name": "单手剑",
"desc": "由纯净的翠玉精琢细雕而成的仪礼宝剑,挥舞时剑风中似有叹息之声。",
"affix_level": 1
},
"reliquaries": [
{
"id": 71544,
"name": "历经风雪的思念",
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/equip/UI_RelicIcon_14001_4.png",
"pos": 1,
"rarity": 5,
"level": 20,
"set": {
"id": 2140011,
"name": "冰风迷途的勇士",
"affixes": [
{
"activation_number": 2,
"effect": "获得15%冰元素伤害加成。"
},
...
]
},
"pos_name": "生之花"
},
...
],
"constellations": [
{
"id": 21,
"name": "霜杀墨染樱",
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/constellation_icon/UI_Talent_S_Ayaka_01.png",
"effect": "神里绫华的普通攻击或重击对敌人造成<color=#99FFFFFF>冰元素伤害</color>时,有50%的几率使<color=#FFD780FF>神里流·冰华</color>的冷却时间缩减0.3秒。该效果每0.1秒只能触发一次。",
"is_actived": false,
"pos": 1
},
...
],
"actived_constellation_num": 0,
"costumes": [],
"external": null
},
...
],
"role": {
"AvatarUrl": "",
"nickname": "玄天",
"region": "cn_gf01",
"level": 56
}
}
}
国际服:
请求方式:POST
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
未知
参数:
JSON返回
获取深境螺旋信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://api-takumi-record.mihoyo.com/game_record/app/genshin/api/spiralAbyss
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
server | str | 服务器名称 | |
role_id | num | 原神UID | |
schedule_type | num | 要查询的是哪期深渊信息 1 当期 2 上期 |
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 10102 目标用户未公开数据 | |
message | str | 返回消息 | |
data | obj | 该游戏账号的深境螺旋信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
schedule_id | num | 这期深境螺旋的ID | |
start_time | str | 这期深境螺旋开始时的Unix时间戳 | |
end_time | str | 这期深境螺旋结束时间的Unix时间戳 | |
total_battle_times | num | 该玩家在这期深境螺旋总共战斗的间数量 | |
total_win_times | num | 该玩家在这期深境螺旋总共胜利的间数量 | |
max_floor | str | 该玩家在这期最深抵达的间 | |
reveal_rank | arr | 该玩家在这期深境螺旋使用次数最多的角色的信息 | |
defeat_rank | arr | 该玩家在这期深境螺旋击破数量最多的角色的信息 | |
damage_rank | arr | 该玩家在这期深境螺旋中伤害最大的角色的信息 | |
take_damage_rank | arr | 该玩家在这期深境螺旋中承受伤害最多的角色的信息 | |
normal_skill_rank | arr | 该玩家在这期深境螺旋中释放最多元素战技的角色的信息 | |
energy_skill_rank | arr | 该玩家在这期深境螺旋中释放最多元素爆发的角色的信息 | |
floors | arr | 该玩家在这期深境螺旋第8层及以上层的信息 | |
total_star | num | 该玩家在这期深境螺旋得到的星的数量 | |
is_unlock | bool | 该玩家是否已解锁渊月螺旋 |
data
对象→reveal_rank
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_id | num | 该角色的ID | |
avatar_icon | str | 该角色的图标 | |
value | num | 该玩家在这期深境螺旋的使用该角色的次数 | |
rarity | num | 该角色的稀有度 |
data
对象→defeat_rank
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_id | num | 该角色的ID | |
avatar_icon | str | 该角色的图标 | |
value | num | 该玩家在这期深境螺旋中该角色击破的次数 | |
rarity | num | 该角色的稀有度 |
data
对象→damage_rank
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_id | num | 该角色的ID | |
avatar_icon | str | 该角色的图标 | |
value | num | 该玩家在这期深境螺旋中该角色输出的最大伤害 | |
rarity | num | 该角色的稀有度 |
data
对象→take_damage_rank
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_id | num | 该角色的ID | |
avatar_icon | str | 该角色的图标 | |
value | num | 该玩家在这期深境螺旋中该角色承受的伤害 | |
rarity | num | 该角色的稀有度 |
data
对象→take_damage_rank
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_id | num | 该角色的ID | |
avatar_icon | str | 该角色的图标 | |
value | num | 该玩家在这期深境螺旋中该角色承受的伤害 | |
rarity | num | 该角色的稀有度 |
data
对象→normal_skill_rank
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_id | num | 该角色的ID | |
avatar_icon | str | 该角色的图标 | |
value | num | 该玩家在这期深境螺旋中该角色释放的元素战技数量 | |
rarity | num | 该角色的稀有度 |
data
对象→energy_skill_rank
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
avatar_id | num | 该角色的ID | |
avatar_icon | str | 该角色的图标 | |
value | num | 该玩家在这期深境螺旋中该角色释放的元素爆发数量 | |
rarity | num | 该角色的稀有度 |
data
对象→floors
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
index | num | 该层的位置 | |
icon | 该层的图标,似乎没有用 | ||
is_unlock | bool | 该玩家是否已通过这层 | |
settle_time | num | 该玩家通过这层的时间 | 总是为0 |
star | num | 该玩家在这层获得的星的数量 | |
max_star | num | 该层最多可获得的星的数量 | |
levels | arr | 该层的间的信息 |
data
对象→floors
数组→对象→levels
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
index | num | 该间的位置 | |
star | num | 该玩家在这间获得的星的数量 | |
max_star | num | 这间最多可获得的星的数量 | |
battles | arr | 该玩家在这间的上半、下半的战斗信息 |
data
对象→floors
数组→对象→levels
数组→对象→battles
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
index | num | 1 上半 2 下半 | |
timestamp | str | 该玩家开始战斗时的Unix时间戳 | |
avatars | arr | 该玩家在该间的上半或下半战斗使用的角色的信息 |
data
对象→floors
数组→对象→levels
数组→对象→battles
数组→对象→avatars
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该角色的ID | |
icon | str | 该角色的图标 | |
level | num | 该角色的等级 | |
rarity | num | 该角色的稀有度 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"schedule_id": 63,
"start_time": "1675195200",
"end_time": "1676491199",
"total_battle_times": 32,
"total_win_times": 20,
"max_floor": "12-3",
"reveal_rank": [
{
"avatar_id": 10000052,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"value": 16,
"rarity": 5
},
{
"avatar_id": 10000030,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"value": 14,
"rarity": 5
},
{
"avatar_id": 10000025,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"value": 14,
"rarity": 4
},
{
"avatar_id": 10000073,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"value": 13,
"rarity": 5
}
],
"defeat_rank": [
{
"avatar_id": 10000052,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_side_icon/UI_AvatarIcon_Side_Shougun.png",
"value": 63,
"rarity": 5
}
],
"damage_rank": [
{
"avatar_id": 10000052,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_side_icon/UI_AvatarIcon_Side_Shougun.png",
"value": 127921,
"rarity": 5
}
],
"take_damage_rank": [
{
"avatar_id": 10000052,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_side_icon/UI_AvatarIcon_Side_Shougun.png",
"value": 175343,
"rarity": 5
}
],
"normal_skill_rank": [
{
"avatar_id": 10000032,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_side_icon/UI_AvatarIcon_Side_Bennett.png",
"value": 112,
"rarity": 4
}
],
"energy_skill_rank": [
{
"avatar_id": 10000047,
"avatar_icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_side_icon/UI_AvatarIcon_Side_Kazuha.png",
"value": 62,
"rarity": 5
}
],
"floors": [
{
"index": 8,
"icon": "",
"is_unlock": true,
"settle_time": "0",
"star": 9,
"max_star": 9,
"levels": [
{
"index": 1,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675518215",
"avatars": [
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000023,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xiangling.png",
"level": 90,
"rarity": 4
},
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675518263",
"avatars": [
{
"id": 10000078,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Alhatham.png",
"level": 80,
"rarity": 5
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
}
]
}
]
},
{
"index": 2,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675518335",
"avatars": [
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000023,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xiangling.png",
"level": 90,
"rarity": 4
},
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675518383",
"avatars": [
{
"id": 10000078,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Alhatham.png",
"level": 80,
"rarity": 5
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
}
]
}
]
},
{
"index": 3,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675518455",
"avatars": [
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000023,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xiangling.png",
"level": 90,
"rarity": 4
},
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675518507",
"avatars": [
{
"id": 10000078,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Alhatham.png",
"level": 80,
"rarity": 5
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
}
]
}
]
}
]
},
{
"index": 9,
"icon": "",
"is_unlock": true,
"settle_time": "0",
"star": 9,
"max_star": 9,
"levels": [
{
"index": 1,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675195660",
"avatars": [
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000039,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Diona.png",
"level": 73,
"rarity": 4
},
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
}
]
},
{
"index": 2,
"timestamp": "1675195715",
"avatars": [
{
"id": 10000022,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Venti.png",
"level": 90,
"rarity": 5
},
{
"id": 10000075,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Wanderer.png",
"level": 90,
"rarity": 5
},
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
}
]
}
]
},
{
"index": 2,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675195765",
"avatars": [
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000039,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Diona.png",
"level": 73,
"rarity": 4
},
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
}
]
},
{
"index": 2,
"timestamp": "1675195832",
"avatars": [
{
"id": 10000022,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Venti.png",
"level": 90,
"rarity": 5
},
{
"id": 10000075,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Wanderer.png",
"level": 90,
"rarity": 5
},
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
}
]
}
]
},
{
"index": 3,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675195880",
"avatars": [
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000039,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Diona.png",
"level": 73,
"rarity": 4
},
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
}
]
},
{
"index": 2,
"timestamp": "1675195929",
"avatars": [
{
"id": 10000022,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Venti.png",
"level": 90,
"rarity": 5
},
{
"id": 10000075,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Wanderer.png",
"level": 90,
"rarity": 5
},
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
}
]
}
]
}
]
},
{
"index": 10,
"icon": "",
"is_unlock": true,
"settle_time": "0",
"star": 9,
"max_star": 9,
"levels": [
{
"index": 1,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675196184",
"avatars": [
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675196243",
"avatars": [
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000022,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Venti.png",
"level": 90,
"rarity": 5
},
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
}
]
}
]
},
{
"index": 2,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675196304",
"avatars": [
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675196338",
"avatars": [
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000022,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Venti.png",
"level": 90,
"rarity": 5
},
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
}
]
}
]
},
{
"index": 3,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675196375",
"avatars": [
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675196405",
"avatars": [
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000022,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Venti.png",
"level": 90,
"rarity": 5
},
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
}
]
}
]
}
]
},
{
"index": 11,
"icon": "",
"is_unlock": true,
"settle_time": "0",
"star": 9,
"max_star": 9,
"levels": [
{
"index": 1,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675421955",
"avatars": [
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000022,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Venti.png",
"level": 90,
"rarity": 5
},
{
"id": 10000059,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Heizo.png",
"level": 70,
"rarity": 4
},
{
"id": 10000076,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Faruzan.png",
"level": 80,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675422299",
"avatars": [
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
}
]
}
]
},
{
"index": 2,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675196645",
"avatars": [
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675196706",
"avatars": [
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000023,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xiangling.png",
"level": 90,
"rarity": 4
},
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
}
]
}
]
},
{
"index": 3,
"star": 3,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675196815",
"avatars": [
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675196863",
"avatars": [
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000023,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xiangling.png",
"level": 90,
"rarity": 4
},
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
}
]
}
]
}
]
},
{
"index": 12,
"icon": "",
"is_unlock": true,
"settle_time": "0",
"star": 6,
"max_star": 9,
"levels": [
{
"index": 1,
"star": 2,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675560429",
"avatars": [
{
"id": 10000078,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Alhatham.png",
"level": 80,
"rarity": 5
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
}
]
},
{
"index": 2,
"timestamp": "1675560593",
"avatars": [
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000023,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xiangling.png",
"level": 90,
"rarity": 4
}
]
}
]
},
{
"index": 2,
"star": 2,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675561066",
"avatars": [
{
"id": 10000078,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Alhatham.png",
"level": 80,
"rarity": 5
},
{
"id": 10000031,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Fischl.png",
"level": 80,
"rarity": 4
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
},
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
}
]
},
{
"index": 2,
"timestamp": "1675561261",
"avatars": [
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
},
{
"id": 10000023,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xiangling.png",
"level": 90,
"rarity": 4
}
]
}
]
},
{
"index": 3,
"star": 2,
"max_star": 3,
"battles": [
{
"index": 1,
"timestamp": "1675197621",
"avatars": [
{
"id": 10000073,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Nahida.png",
"level": 90,
"rarity": 5
},
{
"id": 10000052,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Shougun.png",
"level": 90,
"rarity": 5
},
{
"id": 10000025,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Xingqiu.png",
"level": 90,
"rarity": 4
},
{
"id": 10000032,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Bennett.png",
"level": 90,
"rarity": 4
}
]
},
{
"index": 2,
"timestamp": "1675197742",
"avatars": [
{
"id": 10000002,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Ayaka.png",
"level": 90,
"rarity": 5
},
{
"id": 10000047,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Kazuha.png",
"level": 90,
"rarity": 5
},
{
"id": 10000030,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Zhongli.png",
"level": 90,
"rarity": 5
},
{
"id": 10000014,
"icon": "https://upload-bbs.mihoyo.com/game_record/genshin/character_icon/UI_AvatarIcon_Barbara.png",
"level": 52,
"rarity": 4
}
]
}
]
}
]
}
],
"total_star": 42,
"is_unlock": true
}
}
国际服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
未知
获取祈愿记录
国服:
请求方式:GET
https://hk4e-api.mihoyo.com/event/gacha_info/api/getGachaLog
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
authkey_ver | num | 1 | |
authkey | str | 用于标识游戏账号的Auth Key B | 获取方法: 1. 游戏内打开一次祈愿记录页面,然后在“游戏安装目录/YuanShen_Data/webCaches/Cache/Cache_Data/data_2”,寻找类似“https://hk4e-api.mihoyo.com/event/gacha_info/api/getGachaLog……”的链接,该参数的值在其中 2. 通过SToken获取账号Auth Key B使请求体字段 auth_appid 为webview_gacha |
lang | str | 语言,即返回数据中抽到的项目名称 zh-cn zh 简体中文 zh-tw 繁体中文 en-us en 英语 ru-ru ru 俄语 ja-jp ja 日语 以及其它国际语言代码 | |
size | num | 返回数据中的最大数据数量。最小为0,最大为20。若小于0,则返回0个数据;若大于20,则返回最大20个数据 | |
end_id | num | 见下文的说明 | |
page | num | 页数,从1开始 | 若为负数返回则会是-502 。若没有此参数,默认为第1页。该参数实际上没有用处,要实现翻页请使用end_id 参数。见下文。 |
gacha_type | num | 祈愿池 100 初行者推荐祈愿 200 常驻祈愿 301 角色活动祈愿 302 武器活动祈愿 |
当需要获取超过20个记录时,需要使用到end_id
参数。
具体步骤:
- 当
page
为1
(即第1页)时,需要指定end_id
为0
。则会返回最新的参数size
个祈愿记录。 - 当需要翻页(增加
page
)时,需要指定end_id
为上页的data
对象→list
数组→最后一个元素→id
字符串。 - 重复第2步,直到获取完成想要获取的祈愿记录数量。
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 -100 请求参数 authkey 不正确-108 未指定语言或不是支持的语言 -110 请求过快 | |
message | str | 返回消息 | |
data | obj | 该游戏账号的祈愿信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
page | num | 页数 | 与请求参数中的page 参数的值相同 |
size | num | 最大数据数量 | 与请求参数中的size 参数的值相同 |
total | num | 0 | |
list | arr | 从新至旧排序的祈愿记录 | |
region | str | 该账号所属服务器的标识 |
data
对象→list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
uid | str | 该玩家的UID | |
gacha_type | str | 祈愿池 | 与请求参数中的gacha_type 参数的值相同(角色活动祈愿-2除外,为400 ) |
item_id | str | 似乎总是为空字符串 | |
count | str | 1 | |
time | str | 该玩家抽到该项目的日期 | |
name | str | 抽到的项目名称 | 文本语言通过参数lang 指定 |
lang | str | 语言 | 与请求参数中的lang 参数的值相同 |
item_type | str | 该项目的类别 | 文本语言通过参数lang 指定 |
rank_type | str | 该项目的稀有度 | |
id | str | 该祈愿记录的ID,可用于翻页获取祈愿记录。 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"page": "0",
"size": "20",
"total": "0",
"list": [
{
"uid": "222681079",
"gacha_type": "302",
"item_id": "",
"count": "1",
"time": "2023-04-21 20:54:19",
"name": "铁影阔剑",
"lang": "zh-cn",
"item_type": "武器",
"rank_type": "3",
"id": "1682078760003138679"
}
],
"region": "cn_gf01"
}
}
国际服:
未知
崩坏:星穹铁道
获取首页信息
国服:
请求方式:GET
需要验证请求头
x-rpc-client_type
:5
4X
salt
DS2
需要验证Cookie
LToken
https://api-takumi-record.mihoyo.com/game_record/app/hkrpg/api/index
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
role_id | num | 星穹铁道UID | |
server | str | 服务器名称 |
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | 玩家信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
stats | obj | 玩家基础信息 | |
avatar_list | arr | 该玩家拥有的角色的基本信息 |
data
对象→stats
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
active_days | num | 该玩家的游玩天数 | |
avatar_num | num | 该玩家拥有的角色数量 | |
achievement_num | num | 该玩家已解锁的成就数量 | |
chest_num | num | 该玩家已发现的战利品数量 | |
abyss_process | str | 该玩家达成的忘却之庭层级 |
data
对象→avatar_list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | 该角色的ID | |
name | str | 角色名称 | |
element | str | 该角色的元素属性 | 英文 |
icon | str | 该角色的头像 | |
rarity | num | 该角色的稀有度 | |
rank | num | 待调查 | |
is_chosen | bool | 是否收藏了该角色 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"stats": {
"active_days": 17,
"avatar_num": 15,
"achievement_num": 154,
"chest_num": 209,
"abyss_process": "回忆其六"
},
"avatar_list": [
{
"id": 1209,
"level": 60,
"name": "彦卿",
"element": "ice",
"icon": "https://uploadstatic.mihoyo.com/darkmatter/hkrpg/prod_gf_cn/item_icon_7a87fe/a5512decb10359dd6e1484085da105de.png",
"rarity": 5,
"rank": 0,
"is_chosen": false
},
...
]
}
}
国际服:
未知
获取角色信息
获取忘却之庭信息
获取跃迁记录
国服:
请求方式:GET
https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
authkey_ver | num | 1 | |
authkey | str | 用于标识游戏账号的Auth Key B | 获取方法: 游戏内打开一次跃迁记录页面,然后在“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”,寻找类似“https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……”的链接,该参数的值在其中 |
lang | str | 语言,即返回数据中抽到的项目名称 zh-cn zh 简体中文 zh-tw 繁体中文 en-us en 英语 ru-ru ru 俄语 ja-jp ja 日语 以及其它国际语言代码 | |
size | num | 返回数据中的最大数据数量。最小为0,最大为20。若小于0,则返回0个数据;若大于20,则返回最大20个数据 | |
end_id | num | 见下文的说明 | |
page | num | 页数,从1开始 | 若为负数返回则会是-502 。若没有此参数,默认为第1页。该参数实际上没有用处,要实现翻页请使用end_id 参数。见下文。 |
gacha_type | num | 跃迁池 1 常驻跃迁 2 新手跃迁 11 角色活动跃迁 12 光锥活动跃迁 | |
game_biz | str | authkey 对应账号所属服务器的服务器标识 |
当需要获取超过20个记录时,需要使用到end_id
参数。
具体步骤:
- 当
page
为1
(即第1页)时,需要指定end_id
为0
。则会返回最新的参数size
个跃迁记录。 - 当需要翻页(增加
page
)时,需要指定end_id
为上页的data
对象→list
数组→最后一个元素→id
字符串。 - 重复第2步,直到获取完成想要获取的跃迁记录数量。
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 -100 请求参数 authkey 不正确-111 请求参数 game_biz 不正确-108 未指定语言或不是支持的语言 -110 请求过快 | |
message | str | 返回消息 | |
data | obj | 该游戏账号的祈愿信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
page | num | 页数 | 与请求参数中的page 参数的值相同 |
size | num | 该页的跃迁记录数量 | |
list | arr | 跃迁记录 | |
region | str | 该账号所属服务器的标识 | |
region_time_zone | num | 该玩家的所在时区的UTC时间偏移量 |
data
对象→list
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
uid | str | 该玩家的UID | |
gacha_id | str | 该跃迁记录所在的跃迁池的ID | |
gacha_type | str | 跃迁池 | 与请求参数中的gacha_type 参数的值相同 |
item_id | str | 该项目的ID | |
count | str | 1 | |
time | str | 该玩家抽到该项目的日期 | |
name | str | 抽到的项目名称 | 文本语言通过参数lang 指定 |
lang | str | 语言 | 与请求参数中的lang 参数的值相同 |
item_type | str | 该项目的类别 | 文本语言通过参数lang 指定 |
rank_type | str | 该项目的稀有度 | |
id | str | 该跃迁记录的ID,可用于翻页获取跃迁记录 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"page": "1",
"size": "1",
"list": [
{
"uid": "108976226",
"gacha_id": "3003",
"gacha_type": "12",
"item_id": "20003",
"count": "1",
"time": "2023-05-07 15:15:27",
"name": "琥珀",
"lang": "zh-cn",
"item_type": "光锥",
"rank_type": "3",
"id": "1683443400001878626"
}
],
"region": "prod_gf_cn",
"region_time_zone": 8
}
}
国际服:
未知
获取开拓月历
国服:
请求方式:GET
需要验证Cookie
Cookie Token:
cookie_token
https://api-takumi.mihoyo.com/event/srledger/month_info
参数:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
uid | num | 星穹铁道UID | |
region | str | 服务器名称 | |
month | str | 抽卡月份 | 指定查询月份,为空时查询当月数据,只能查询最近3个月数据,格式 YYYYMM |
JSON返回:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
retcode | num | 返回码 | |
message | str | 返回消息 | |
data | obj | 玩家信息 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
data_month | str | 数据对应的月份 | 格式 YYYYMM |
data_text | obj | 未知 | |
day_data | obj | 当日数据 | |
login_flag | bool | 登陆标识 | |
month | str | 查询时的月份 | 格式 YYYYMM |
month_data | obj | 月历数据 | |
optional_month | arr | 可查询数据的月份 | 列表中为字符串,时间格式 YYYYMM |
region | str | 服务器名称 | |
start_month | str | 账号注册月份 | 格式 YYYYMM |
uid | num | 星穹铁道UID | |
version | num | 游戏版本 | 此字段内容待确认 |
data
对象→data_text
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
key | str | 未知 | |
mi18n_key | num | 未知 | |
type | str | 未知 |
data
对象→day_data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
current_hcoin | num | 当日星穹数量 | |
current_rails_pass | num | 当日星轨通票与星轨专票数量 | |
last_hcoin | num | 前日星穹数量 | |
last_rails_pass | num | 前日星轨通票与星轨专票数量 |
data
对象→month_data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
current_hcoin | num | 当月星穹数量 | |
current_rails_pass | num | 当月星轨通票与星轨专票数量 | |
group_by | arr | 星穹数据来源详情 | |
hcoin_rate | num | 星琼数量较上月的增长率 | |
last_hcoin | num | 上月星穹数量 | |
last_rails_pass | num | 上月星轨通票与星轨专票数量 | |
rails_rate | num | 星轨通票与星轨专票数量较上月的增长率 |
month_data
对象→group_by
数组→对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
action | str | 星穹来源 | |
action_name | str | 星穹来源名称 | |
num | num | 星穹数量 | |
percent | num | 从该来源获取的星穹数量占总数的比例 |
查看示例
{
"retcode": 0,
"message": "OK",
"data": {
"uid": "123456789",
"region": "prod_gf_cn",
"login_flag": true,
"optional_month": [
"202308",
"202307",
"202306"
],
"month": "202308",
"data_month": "202308",
"month_data": {
"current_hcoin": 3245,
"current_rails_pass": 17,
"last_hcoin": 8916,
"last_rails_pass": 35,
"hcoin_rate": -63,
"rails_rate": -51,
"group_by": [
{
"action": "daily_reward",
"num": 2025,
"percent": 62,
"action_name": "每日活跃"
},
{
"action": "adventure_reward",
"num": 375,
"percent": 11,
"action_name": "冒险奖励"
},
{
"action": "mail_reward",
"num": 340,
"percent": 10,
"action_name": "邮件奖励"
},
{
"action": "event_reward",
"num": 220,
"percent": 6,
"action_name": "活动奖励"
},
{
"action": "space_reward",
"num": 225,
"percent": 6,
"action_name": "模拟宇宙奖励"
},
{
"action": "other",
"num": 0,
"percent": 4,
"action_name": "其他"
},
{
"action": "abyss_reward",
"num": 60,
"percent": 1,
"action_name": "忘却之庭奖励"
}
]
},
"day_data": {
"current_hcoin": 0,
"current_rails_pass": 0,
"last_hcoin": 515,
"last_rails_pass": 0
},
"version": "1.2",
"start_month": "202304",
"data_text": {
"type": "TextDay",
"key": "102_000",
"mi18n_key": "2"
}
}
}