跳至主要內容

游戏账号信息

UIGF-org大约 35 分钟

游戏账号信息

获取游戏记录卡片信息

国服：

请求方式：GET

需要验证请求头

x-rpc-client_type：2

K2salt

DS1

需要验证Cookie

SToken

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

参数：

字段类型内容备注
uidstr想要获取游戏记录卡片信息的米游社账号ID

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj该米游社账号的所有游戏记录卡片信息

data对象：

字段类型内容备注
listarr所有游戏记录卡片信息

data对象→list数组→对象：

字段类型内容备注
has_rolebool该账号是否已绑定该游戏的任何账号
game_idnum该游戏记录对应的游戏ID
game_role_idstr该游戏记录展示的游戏账号ID
nicknamestr该游戏账号的昵称
regionstr该游戏账号所属服务器的名称
levelnum该游戏账号的等级例如原神的冒险等级
background_imagestr该游戏记录卡片背景图片的URL
is_publicbool该账号是否公开该游戏记录
dataarr该游戏记录的一些简略信息
region_namestr该游戏账号所属服务器的称呼
urlstr该游戏记录卡片将跳转页面的URL
data_switchesarr待调查
h5_data_switchesarr待调查
background_colorstr该卡片背景颜色的16进制颜色值

data对象→list数组→对象→data数组→对象：

字段类型内容备注
namestr该记录项的名称
typenum待调查
valuestr该记录项的数据

data对象→list数组→对象→data_switches数组→对象：

字段类型内容备注
switch_idstr待调查
is_publicbool待调查
switch_namestr待调查
查看示例
{
  "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

4Xsalt

DS2

需要验证Cookie

LToken

https://api-takumi.mihoyo.com/binding/api/getUserGameRolesByCookie

参数：

字段类型内容备注
game_bizstr游戏标识符若该值为空，将返回所有绑定游戏账号的信息

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobjCookie对应米游社账号绑定的游戏账号信息

data对象：

字段类型内容备注
listarr游戏账号基本信息

data对象→list数组→对象：

字段类型内容备注
game_bizstr该游戏账号所属游戏的标识符
regionstr该游戏账号所在服务器的名称
game_uidstr该游戏账号的UID
nicknamestr该游戏账号的昵称
levelnum该游戏账号的等级
is_chosenbool是否已收藏该游戏账号
region_namestr该游戏账号所在服务器的称呼
is_officialbool该游戏账号所在服务器是否为官方服务器
查看示例
{
  "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

K2salt

DS1

需要验证Cookie

SToken

https://api-takumi.miyoushe.com/binding/api/getUserGameRolesByStoken

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobjCookie对应米游社账号绑定的游戏账号信息

data对象：

字段类型内容备注
listarr游戏账号基本信息

data对象→list数组→对象：

字段类型内容备注
game_bizstr该游戏账号所属游戏的标识符
regionstr该游戏账号所在服务器的名称
game_uidstr该游戏账号的UID
nicknamestr该游戏账号的昵称
levelnum该游戏账号的等级
is_chosenbool是否已收藏该游戏账号
region_namestr该游戏账号所在服务器的称呼
is_officialbool该游戏账号所在服务器是否为官方服务器
查看示例
{
  "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_ticketstr用于获取绑定游戏账号信息的有效Action Ticket
game_bizstr游戏标识符若该值为空，将返回所有绑定游戏账号的信息

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobjCookie对应米游社账号绑定的游戏账号信息

data对象：

字段类型内容备注
listarr游戏账号基本信息

data对象→list数组→对象：

字段类型内容备注
game_bizstr该游戏账号所属游戏的标识符
regionstr该游戏账号所在服务器的名称
game_uidstr该游戏账号的UID
nicknamestr该游戏账号的昵称
levelnum该游戏账号的等级
is_chosenbool是否已收藏该游戏账号
region_namestr该游戏账号所在服务器的称呼
is_officialbool该游戏账号所在服务器是否为官方服务器
查看示例
{
  "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

4Xsalt

DS2

需要验证Cookie

LToken

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

参数：

字段类型内容备注
role_idnum原神UID
serverstr服务器名称

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj玩家信息

data对象：

字段类型内容备注
roleobj玩家基础信息
avatarsarr玩家拥有的角色的信息若Cookie对应的账号不是自己的，则只返回好感度最高的8个角色。
statsobj玩家世界信息
city_explorationsarr待调查似乎没有用
world_explorationsarr玩家的世界探索信息
homesarr玩家的尘歌壶信息

data对象→role对象：

字段类型内容备注
AvatarUrlstr玩家头像总是为空字符串
nicknamestr玩家昵称
regionstr玩家账号的服务器名称
levelnum玩家的冒险等级

data对象→avatars数组→对象：

字段类型内容备注
idnum该角色的ID
imagestr该角色的头像
elementstr该角色的元素英文
fetternum该角色的好感度
levelnum该角色的等级
raritynum该角色的稀有度
actived_constellation_numnum该角色的已激活命之座数量
card_imagestr该角色的角色卡
is_chosenbool是否收藏了该角色

data对象→stats对象：

字段类型内容备注
active_day_numbernum该玩家的游玩天数
achievement_numbernum该玩家已达成的成就数量
anemoculus_numbernum该玩家已供奉的风神瞳数量
geoculus_numbernum该玩家已供奉的岩神瞳数量
avatar_numbernum该玩家拥有的角色数量
way_point_numbernum该玩家已激活的传送锚点数量
domain_numbernum该玩家已激活的秘境入口数量
spiral_abyssnum该玩家当前的深境螺旋层级
precious_chest_numbernum该玩家已开启的珍贵的宝箱数量
luxurious_chest_numbernum该玩家已开启的华丽的宝箱数量
exquisite_chest_numbernum该玩家已开启的精致的宝箱数量
common_chest_numbernum该玩家已开启的普通的宝箱数量
electroculus_numbernum该玩家已供奉的雷神瞳数量
magic_chest_numbernum该玩家已开启的奇馈宝箱数量
dendroculus_numbernum该玩家已供奉的草神瞳数量

data对象→world_explorations数组→对象：

字段类型内容备注
levelnum地区声望等级
exploration_percentagenum地区探索度百分比×10，例如10%探索度则该字段为100
iconstr地区图标
namestr地区名称
typestrReputation 声望
offeringsarr该地区除神像以外的等级信息，例如须弥的梦之树、稻妻的神樱树等
idnum该地区的ID
parent_idnum父地区的ID
map_urlstr该地区在米游社观测枢原神大地图的链接
strategy_urlstr该地区在米游社攻略的链接
background_imagestr该地区的背景图
inner_iconstr该地区的图标
coverstr该地区的覆盖图

data对象→world_explorations数组→对象→offerings数组→对象：

字段类型内容备注
namestr名称
levelnum等级
iconstr图标

data对象→homes数组→对象：

字段类型内容备注
levelnum该玩家的尘歌壶等级
visit_numnum该玩家的尘歌壶总造访人数
comfort_numnum尘歌壶该岛的洞天仙力
item_numnum该玩家的摆设图纸数量
namestr尘歌壶该岛的名称
iconstr尘歌壶该岛的图标
comfort_level_namestr尘歌壶该岛的洞天仙力的称号
comfort_level_iconstr尘歌壶该岛的洞天仙力的图标
查看示例
{
  "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

4Xsalt

DS2

需要验证Cookie

LToken

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

参数：

字段类型内容备注
role_idnum原神UID
serverstr服务器名称

获取游戏账号基本信息

国服：

请求方式：GET

需要验证请求头

x-rpc-client_type：5

4Xsalt

DS2

需要验证Cookie

LToken

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

参数：

字段类型内容备注
serverstr服务器名称
role_idnum原神UID

JSON返回

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj该游戏账号的基本信息

data对象：

字段类型内容备注
AvatarUrlstr空字符串
nicknamestr该游戏账号的昵称
regionstr该游戏账号所属服务器的名称
levelnum该游戏账号的冒险等级
card_play_levelnum待调查
查看示例
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "AvatarUrl": "",
    "nickname": "※青衫入雨※",
    "region": "cn_gf01",
    "level": 59,
    "card_play_level": 0
  }
}

获取实时便笺信息

国服：

请求方式：GET

需要验证请求头

x-rpc-client_type：5

4Xsalt

DS2

需要验证Cookie

LToken

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

参数：

字段类型内容备注
serverstr服务器名称
role_idnum原神UID

JSON返回

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj该游戏账号的实时便笺信息

data对象：

字段类型内容备注
current_resinnum当前树脂
max_resinnum树脂上限恒为160
resin_recovery_timestr树脂恢复时间以秒为单位
finished_task_numnum已完成任务数为日常委托完成数
total_task_numnum总任务数为日常委托总数
is_extra_task_reward_receivedbool是否领取额外奖励
remain_resin_discount_numnum剩余周本折扣次数
resin_discount_num_limitnum周本折扣次数上限
current_expedition_numnum当前探索次数
max_expedition_numnum探索次数上限
expeditionsarr探索队伍信息
current_home_coinnum当前家园币
max_home_coinnum家园币上限
home_coin_recovery_timestr家园币恢复时间以秒为单位
calendar_urlstr日历链接
transformerobj转换器信息
daily_taskobj日常任务信息
archon_quest_progressobj主线任务进度

data对象→expeditions数组→对象：

字段类型内容备注
avatar_side_iconstr角色头像
statusstr状态Ongoing-派遣中
Finished-完成
remained_timestr剩余时间以秒为单位

data对象→transformer对象：

字段类型内容备注
obtainedbool是否获得
recovery_timeobj恢复时间
wikistr百科链接
noticedbool是否通知
latest_job_idstr最新任务ID

data对象→transformer对象→recovery_time对象：

字段类型内容备注
Daynum天数
Hournum小时
Minutenum分钟
Secondnum秒数
reachedbool是否到达

data对象→daily_task对象：

字段类型内容备注
total_numnum总任务数
finished_numnum已完成任务数
is_extra_task_reward_receivedbool是否领取额外奖励
task_rewardsarr任务奖励
attendance_rewardsarr签到奖励
attendance_visiblebool是否显示签到

data对象→daily_task对象→task_rewards数组→对象：

字段类型内容备注
statusstr状态

task_rewards.status 枚举类型如下：

  • TaskRewardStatusInvalid：无效
  • TaskRewardStatusTakenAward：已领取
  • TaskRewardStatusUnfinished：未完成
  • TaskRewardStatusFinished：已完成

data对象→daily_task对象→attendance_rewards数组→对象：

字段类型内容备注
statusstr状态
progressnum进度最大2000

attendance_rewards.status 枚举类型如下：

  • AttendanceRewardStatusInvalid：无效
  • AttendanceRewardStatusTakenAward：已领取
  • AttendanceRewardStatusWaitTaken：等待领取
  • AttendanceRewardStatusUnfinished：未完成
  • AttendanceRewardStatusFinishedNonReward：已完成但无奖励
  • AttendanceRewardStatusForbid：禁止领取

data对象→archon_quest_progress对象：

字段类型内容备注
listarr任务列表
is_open_archon_questbool是否开启主线任务
is_finish_all_mainlinebool是否完成所有主线任务
is_finish_all_interchapterbool是否完成所有间章任务
wiki_urlstr百科链接

data对象→archon_quest_progress对象→list数组→对象：

字段类型内容备注
idnum任务ID
chapter_titlestr任务名称
chapter_numstr任务章节
statusstr任务状态

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

4Xsalt

DS2

需要验证Cookie

LToken

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

参数：

字段类型内容备注
serverstr服务器名称
role_idnum原神UID

JSON返回

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj该游戏账号的角色信息

data对象：

字段类型内容备注
avatarsarr该账号拥有的角色的信息若Cookie对应的账号不是自己的，则只返回好感度最高的8个角色。
roleobj该账号的基本信息

data对象→avatars数组→对象：

字段类型内容备注
idnum角色ID
imagestr角色的图像
iconstr角色的图标
namestr角色姓名
elementstr角色的元素英文
fetternum角色好感度
levelnum角色等级
raritynum角色稀有度
weaponobj角色持有武器的信息
reliquariesarr角色佩戴的圣遗物的信息
constellationsarr角色的命之座信息
actived_constellation_numnum该角色已点亮的命之座数量
costumesarr该账号拥有的该角色衣装信息
external待调查

data对象→avatars数组→对象→weapon对象：

字段类型内容备注
idnum该武器ID
namestr该武器的名称
iconstr该武器的图标
typenum该武器的类型
raritynum该武器的稀有度
levelnum该武器的等级
promote_levelnum该武器的精炼等级
type_namestr该武器所属类型的名称
descstr该武器的描述
affix_levelnum待调查

data对象→avatars数组→对象→reliquaries数组→对象：

字段类型内容备注
idnum该圣遗物的ID
namestr该圣遗物的名称
iconstr该圣遗物的图标
posnum该圣遗物的位置
1 生之花
2 死之羽
3 空之杯
4 时之沙
5 理之冠
raritynum该圣遗物的稀有度
levelnum该圣遗物的等级
setobj该圣遗物所属的圣遗物套装的信息
pos_namestr该圣遗物的位置的名称

data对象→avatars数组→对象→reliquaries数组→对象→set对象：

字段类型内容备注
idnum该圣遗物套装的ID
namestr该圣遗物套装的名称
affixesarr该圣遗物套装的套装效果信息

data对象→avatars数组→对象→reliquaries数组→对象→set对象→affixes数组→对象：

字段类型内容备注
activation_numbernum需要装备多少该套装内的圣遗物才能激活该效果
effectstr该圣遗物套装效果的描述

data对象→avatars数组→对象→constellations数组→对象：

字段类型内容备注
idnum该命之座的ID
namestr该命之座的名称
iconstr该命之座的图标
effectstr该命之座的描述
is_activedbool该账号是否已激活该命之座
posnum该命之座的位置

data对象→avatars数组→对象→costumes数组→对象：

字段类型内容备注
idnum该衣装的ID
namestr该衣装的名称
iconstr该衣装的图标

data对象→role对象：

字段类型内容备注
AvatarUrlstr该账号的头像似乎没有用
nicknamestr该账号的昵称
regionstr该账号在的服务器的名称
levelnum该账号的冒险等级
查看示例
{
  "retcode": 0,
  "message": "OK",
  "data": {
    "avatars": [
      {
        "id": 10000002,
        "image": "https://upload-bbs.mihoyo.com/game_record/genshin/character_image/[email protected]",
        "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

4Xsalt

DS2

需要验证Cookie

LToken

未知

参数：

JSON返回

获取深境螺旋信息

国服：

请求方式：GET

需要验证请求头

x-rpc-client_type：5

4Xsalt

DS2

需要验证Cookie

LToken

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

参数：

字段类型内容备注
serverstr服务器名称
role_idnum原神UID
schedule_typenum要查询的是哪期深渊信息
1 当期
2 上期

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
10102 目标用户未公开数据
messagestr返回消息
dataobj该游戏账号的深境螺旋信息

data对象：

字段类型内容备注
schedule_idnum这期深境螺旋的ID
start_timestr这期深境螺旋开始时的Unix时间戳
end_timestr这期深境螺旋结束时间的Unix时间戳
total_battle_timesnum该玩家在这期深境螺旋总共战斗的间数量
total_win_timesnum该玩家在这期深境螺旋总共胜利的间数量
max_floorstr该玩家在这期最深抵达的间
reveal_rankarr该玩家在这期深境螺旋使用次数最多的角色的信息
defeat_rankarr该玩家在这期深境螺旋击破数量最多的角色的信息
damage_rankarr该玩家在这期深境螺旋中伤害最大的角色的信息
take_damage_rankarr该玩家在这期深境螺旋中承受伤害最多的角色的信息
normal_skill_rankarr该玩家在这期深境螺旋中释放最多元素战技的角色的信息
energy_skill_rankarr该玩家在这期深境螺旋中释放最多元素爆发的角色的信息
floorsarr该玩家在这期深境螺旋第8层及以上层的信息
total_starnum该玩家在这期深境螺旋得到的星的数量
is_unlockbool该玩家是否已解锁渊月螺旋

data对象→reveal_rank数组→对象：

字段类型内容备注
avatar_idnum该角色的ID
avatar_iconstr该角色的图标
valuenum该玩家在这期深境螺旋的使用该角色的次数
raritynum该角色的稀有度

data对象→defeat_rank数组→对象：

字段类型内容备注
avatar_idnum该角色的ID
avatar_iconstr该角色的图标
valuenum该玩家在这期深境螺旋中该角色击破的次数
raritynum该角色的稀有度

data对象→damage_rank数组→对象：

字段类型内容备注
avatar_idnum该角色的ID
avatar_iconstr该角色的图标
valuenum该玩家在这期深境螺旋中该角色输出的最大伤害
raritynum该角色的稀有度

data对象→take_damage_rank数组→对象：

字段类型内容备注
avatar_idnum该角色的ID
avatar_iconstr该角色的图标
valuenum该玩家在这期深境螺旋中该角色承受的伤害
raritynum该角色的稀有度

data对象→take_damage_rank数组→对象：

字段类型内容备注
avatar_idnum该角色的ID
avatar_iconstr该角色的图标
valuenum该玩家在这期深境螺旋中该角色承受的伤害
raritynum该角色的稀有度

data对象→normal_skill_rank数组→对象：

字段类型内容备注
avatar_idnum该角色的ID
avatar_iconstr该角色的图标
valuenum该玩家在这期深境螺旋中该角色释放的元素战技数量
raritynum该角色的稀有度

data对象→energy_skill_rank数组→对象：

字段类型内容备注
avatar_idnum该角色的ID
avatar_iconstr该角色的图标
valuenum该玩家在这期深境螺旋中该角色释放的元素爆发数量
raritynum该角色的稀有度

data对象→floors数组→对象：

字段类型内容备注
indexnum该层的位置
icon该层的图标，似乎没有用
is_unlockbool该玩家是否已通过这层
settle_timenum该玩家通过这层的时间总是为0
starnum该玩家在这层获得的星的数量
max_starnum该层最多可获得的星的数量
levelsarr该层的间的信息

data对象→floors数组→对象→levels数组→对象：

字段类型内容备注
indexnum该间的位置
starnum该玩家在这间获得的星的数量
max_starnum这间最多可获得的星的数量
battlesarr该玩家在这间的上半、下半的战斗信息

data对象→floors数组→对象→levels数组→对象→battles数组→对象：

字段类型内容备注
indexnum1 上半
2 下半
timestampstr该玩家开始战斗时的Unix时间戳
avatarsarr该玩家在该间的上半或下半战斗使用的角色的信息

data对象→floors数组→对象→levels数组→对象→battles数组→对象→avatars数组→对象：

字段类型内容备注
idnum该角色的ID
iconstr该角色的图标
levelnum该角色的等级
raritynum该角色的稀有度
查看示例
{
  "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

4Xsalt

DS2

需要验证Cookie

LToken

未知

获取祈愿记录

国服：

请求方式：GET

https://hk4e-api.mihoyo.com/event/gacha_info/api/getGachaLog

参数：

字段类型内容备注
authkey_vernum1
authkeystr用于标识游戏账号的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
langstr语言，即返回数据中抽到的项目名称
zh-cn zh 简体中文
zh-tw 繁体中文
en-us en 英语
ru-ru ru 俄语
ja-jp ja 日语
以及其它国际语言代码
sizenum返回数据中的最大数据数量。最小为0，最大为20。若小于0，则返回0个数据；若大于20，则返回最大20个数据
end_idnum见下文的说明
pagenum页数，从1开始若为负数返回则会是-502。若没有此参数，默认为第1页。该参数实际上没有用处，要实现翻页请使用end_id参数。见下文。
gacha_typenum祈愿池
100 初行者推荐祈愿
200 常驻祈愿
301 角色活动祈愿
302 武器活动祈愿

当需要获取超过20个记录时，需要使用到end_id参数。

具体步骤：

  1. 当page为1（即第1页）时，需要指定end_id为0。则会返回最新的参数size个祈愿记录。
  2. 当需要翻页（增加page）时，需要指定end_id为上页的data对象→list数组→最后一个元素→id字符串。
  3. 重复第2步，直到获取完成想要获取的祈愿记录数量。

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
-100 请求参数authkey不正确
-108 未指定语言或不是支持的语言
-110 请求过快
messagestr返回消息
dataobj该游戏账号的祈愿信息

data对象：

字段类型内容备注
pagenum页数与请求参数中的page参数的值相同
sizenum最大数据数量与请求参数中的size参数的值相同
totalnum0
listarr从新至旧排序的祈愿记录
regionstr该账号所属服务器的标识

data对象→list数组→对象：

字段类型内容备注
uidstr该玩家的UID
gacha_typestr祈愿池与请求参数中的gacha_type参数的值相同（角色活动祈愿-2除外，为400）
item_idstr似乎总是为空字符串
countstr1
timestr该玩家抽到该项目的日期
namestr抽到的项目名称文本语言通过参数lang指定
langstr语言与请求参数中的lang参数的值相同
item_typestr该项目的类别文本语言通过参数lang指定
rank_typestr该项目的稀有度
idstr该祈愿记录的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

4Xsalt

DS2

需要验证Cookie

LToken

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

参数：

字段类型内容备注
role_idnum星穹铁道UID
serverstr服务器名称

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj玩家信息

data对象：

字段类型内容备注
statsobj玩家基础信息
avatar_listarr该玩家拥有的角色的基本信息

data对象→stats对象：

字段类型内容备注
active_daysnum该玩家的游玩天数
avatar_numnum该玩家拥有的角色数量
achievement_numnum该玩家已解锁的成就数量
chest_numnum该玩家已发现的战利品数量
abyss_processstr该玩家达成的忘却之庭层级

data对象→avatar_list数组→对象：

字段类型内容备注
idnum该角色的ID
namestr角色名称
elementstr该角色的元素属性英文
iconstr该角色的头像
raritynum该角色的稀有度
ranknum待调查
is_chosenbool是否收藏了该角色
查看示例
{
  "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_vernum1
authkeystr用于标识游戏账号的Auth Key B获取方法：
游戏内打开一次跃迁记录页面，然后在“游戏安装目录/StarRail_Data/webCaches/Cache/Cache_Data/data_2”，寻找类似“https://api-takumi.mihoyo.com/common/gacha_record/api/getGachaLog……”的链接，该参数的值在其中
langstr语言，即返回数据中抽到的项目名称
zh-cn zh 简体中文
zh-tw 繁体中文
en-us en 英语
ru-ru ru 俄语
ja-jp ja 日语
以及其它国际语言代码
sizenum返回数据中的最大数据数量。最小为0，最大为20。若小于0，则返回0个数据；若大于20，则返回最大20个数据
end_idnum见下文的说明
pagenum页数，从1开始若为负数返回则会是-502。若没有此参数，默认为第1页。该参数实际上没有用处，要实现翻页请使用end_id参数。见下文。
gacha_typenum跃迁池
1 常驻跃迁
2 新手跃迁
11 角色活动跃迁
12 光锥活动跃迁
game_bizstrauthkey对应账号所属服务器的服务器标识

当需要获取超过20个记录时，需要使用到end_id参数。

具体步骤：

  1. 当page为1（即第1页）时，需要指定end_id为0。则会返回最新的参数size个跃迁记录。
  2. 当需要翻页（增加page）时，需要指定end_id为上页的data对象→list数组→最后一个元素→id字符串。
  3. 重复第2步，直到获取完成想要获取的跃迁记录数量。

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
-100 请求参数authkey不正确
-111 请求参数game_biz不正确
-108 未指定语言或不是支持的语言
-110 请求过快
messagestr返回消息
dataobj该游戏账号的祈愿信息

data对象：

字段类型内容备注
pagenum页数与请求参数中的page参数的值相同
sizenum该页的跃迁记录数量
listarr跃迁记录
regionstr该账号所属服务器的标识
region_time_zonenum该玩家的所在时区的UTC时间偏移量

data对象→list数组→对象：

字段类型内容备注
uidstr该玩家的UID
gacha_idstr该跃迁记录所在的跃迁池的ID
gacha_typestr跃迁池与请求参数中的gacha_type参数的值相同
item_idstr该项目的ID
countstr1
timestr该玩家抽到该项目的日期
namestr抽到的项目名称文本语言通过参数lang指定
langstr语言与请求参数中的lang参数的值相同
item_typestr该项目的类别文本语言通过参数lang指定
rank_typestr该项目的稀有度
idstr该跃迁记录的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

参数：

字段类型内容备注
uidnum星穹铁道UID
regionstr服务器名称
monthstr抽卡月份指定查询月份，为空时查询当月数据，只能查询最近3个月数据，格式 YYYYMM

JSON返回：

根对象：

字段类型内容备注
retcodenum返回码
messagestr返回消息
dataobj玩家信息

data对象：

字段类型内容备注
data_monthstr数据对应的月份格式 YYYYMM
data_textobj未知
day_dataobj当日数据
login_flagbool登陆标识
monthstr查询时的月份格式 YYYYMM
month_dataobj月历数据
optional_montharr可查询数据的月份列表中为字符串，时间格式 YYYYMM
regionstr服务器名称
start_monthstr账号注册月份格式 YYYYMM
uidnum星穹铁道UID
versionnum游戏版本此字段内容待确认

data对象→data_text对象：

字段类型内容备注
keystr未知
mi18n_keynum未知
typestr未知

data对象→day_data对象：

字段类型内容备注
current_hcoinnum当日星穹数量
current_rails_passnum当日星轨通票与星轨专票数量
last_hcoinnum前日星穹数量
last_rails_passnum前日星轨通票与星轨专票数量

data对象→month_data对象：

字段类型内容备注
current_hcoinnum当月星穹数量
current_rails_passnum当月星轨通票与星轨专票数量
group_byarr星穹数据来源详情
hcoin_ratenum星琼数量较上月的增长率
last_hcoinnum上月星穹数量
last_rails_passnum上月星轨通票与星轨专票数量
rails_ratenum星轨通票与星轨专票数量较上月的增长率

month_data对象→group_by数组→对象：

字段类型内容备注
actionstr星穹来源
action_namestr星穹来源名称
numnum星穹数量
percentnum从该来源获取的星穹数量占总数的比例
查看示例
{
    "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"
        }
    }
}
统一可交换原神数据标准
Copyright © 2024 UIGF-org