Skip to content

Latest commit

 

History

History
3015 lines (2682 loc) · 95.5 KB

game_account_info.md

File metadata and controls

3015 lines (2682 loc) · 95.5 KB

游戏账号信息


获取游戏记录卡片信息

国服:

请求方式:GET

需要验证请求头

x-rpc-client_type2

K2salt

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_type5

4Xsalt

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_type2

K2salt

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_type5

4Xsalt

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_type5

4Xsalt

DS2

需要验证Cookie

LToken

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

参数:

字段 类型 内容 备注
role_id num 原神UID
server str 服务器名称

获取游戏账号基本信息

国服:

请求方式:GET

需要验证请求头

x-rpc-client_type5

4Xsalt

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_type5

4Xsalt

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_type5

4Xsalt

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_type5

4Xsalt

DS2

需要验证Cookie

LToken

未知

参数:

JSON返回

获取深境螺旋信息

国服:

请求方式:GET

需要验证请求头

x-rpc-client_type5

4Xsalt

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_type5

4Xsalt

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_appidwebview_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参数。

具体步骤:

  1. page1(即第1页)时,需要指定end_id0。则会返回最新的参数size个祈愿记录。
  2. 当需要翻页(增加page)时,需要指定end_id为上页的data对象→list数组→最后一个元素→id字符串。
  3. 重复第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_type5

4Xsalt

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参数。

具体步骤:

  1. page1(即第1页)时,需要指定end_id0。则会返回最新的参数size个跃迁记录。
  2. 当需要翻页(增加page)时,需要指定end_id为上页的data对象→list数组→最后一个元素→id字符串。
  3. 重复第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"
        }
    }
}