东梦接口平台 / 究极院APP-V3 / 获取学员信息

获取学员信息

接口描述: 试试刷新学员信息

HTTP/HTTPS
请求协议
GET/POST
请求方式
UTF-8
编码格式
JSON
返回格式

接口参数

参数名字类型是否必须默认值其他说明
token字符串可选-token, 登录接口返回的token值

返回字段

返回结果类型说明
ret整型状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误
data对象或混合类型业务数据,由各自接口指定,通常为对象
msg字符串提示信息,失败时的错误提示

在线测试   

参数是否必须
service 必须
token 可选

客户端请求示例

{
  "ret": 200,
  "data": {
    "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1", //学员uid
    "realname": "张云利", // 学员姓名
    "telephone": "13456782949", // 学员手机号
    "org_id": 1, // 所属机构id
    "avatar": "https://thirdwx.qlogo.cn/mmopen/vi_32/PiajxSqBRaEIP1qEK5ic0ysbvYGNf0rM0puwJhAnIwt5KHvGLWqoXibYwja52xDcBzocw6NwZycbXxUxJK5Fk0nQw/132", // 头像
    "gender": 0, // 性别:0未知,1男 2女
    "description": "", // 用户简介
    "birthday": "2022-12-22", // 生日
    "ability_total": "1000.0", // 里程碑总战力
    "pet": 2, // 当前选中宠物id
    "gold": "16200.0", // 究极币
    "stone_num": "247.0", // 进化石
    "energy_num": "0.0", // 碎片【目前没启用】
    "teacher_uid": "fa5348a557b80443294be1ab10878e705630ec3d", // 主课老师uid
    "school_time": "", // 开始学琴时间
    "user_pets": [ // 学员宠物列表
      {
        "id": 2, // 宠物id,对应user_pet_id
        "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1", // 学员uid
        "pet_nickname": "音乐宝贝", // 宠物昵称
        "pet_id": 1, // 对应宠物表id
        "pet_level_id": 11, // 对应宠物等级表id
        "flair_id": 1, // 对应宠物资质表id
        "gender": 0, // 宠物资质:0R、1SR、2SSR(稀有)
        "memo": null,
        "created_at": "2023-05-15 11:58:16", // 创建宠物时间
        "updated_at": "2023-05-15 11:58:16",
        "deleted_at": null,
        "pet_name": "蛋蛋兽", // 宠物原名
        "english_abbr": "egg", // 文件名(生成宠物头像、视频使用)
        "head_image": "http://static.doyure.com/dmapi/pets/01_dd_boy@2x.png",
        "img": "http://static.doyure.com/dmapi/pets/01_dd_boy@2x.png",
        "file_path": "http://static.doyure.com/dmapi/pets/01_dd_boy@2x.png",
        "flair_name": "普通", // 资质(暂时未启用):普通、优秀、杰出、卓越、完美
        "level_name": "蛋蛋体", // 宠物形态级别
        "is_hatch" : 1, // 是否可选择孵化状态:0不能选择、1可选择
        "is_evolve": 1, // 是否可以进化
        "is_battle": 1, // 是否上阵
        "need_stone": "10.0", // 进化消耗 进化石数量 (每级要求不一致)
        "need_ability": "1000.0",// 进化要求学员总战力
        "need_evolve": "0.0", // 吞噬条件
        "pet_same_num": 4, // 相同宠物数量(上阵宠物不叠加),
        // ---------------------------------------   2023-12-13 新增 ------------------------------------------
        "is_repay": 0, // 是否可以重塑
        "repay_stone": "100.00", // 重塑返还进化石
        "repay_gold": "500.00", // 重塑返还究极币数
        "is_logout": 0, // 是否可以放生
        "logout_gold": 100, // 放生返还究极币
        "logout_stone": 10,  // 放生返还进化石
        // ---------------------------------------   2023-12-28 新增 ------------------------------------------
        "evolve_img": "http://static.doyure.com/ultima/pets/image/dragon/1-1.png", // 需吞噬的宠物图标
        "abilities": [ // 学员该宠物能力数据
          [
            {
              "id": 6, // 能力表id
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1", // 学员uid
              "user_pet_id": 2, // 对应学员宠物id
              "ability_id": 1, // 该宠物能力id
              "value": "6.00", // 此项能力值
              "created_at": "2023-05-15 11:58:16",
              "updated_at": "2023-05-15 11:58:16",
              "deleted_at": null,
              "ability_name": "视奏单音", // 能力名称
              "sub_name": "单音" // 能力简称
            },
            {
              "id": 7,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 2,
              "ability_id": 2,
              "value": "5.00",
              "created_at": "2023-05-15 11:58:16",
              "updated_at": "2023-05-15 11:58:16",
              "deleted_at": null,
              "ability_name": "视奏连续音",
              "sub_name": "速音"
            },
            {
              "id": 8,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 2,
              "ability_id": 3,
              "value": "6.00",
              "created_at": "2023-05-15 11:58:16",
              "updated_at": "2023-05-15 11:58:16",
              "deleted_at": null,
              "ability_name": "手指灵活",
              "sub_name": "手指"
            },
            {
              "id": 9,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 2,
              "ability_id": 4,
              "value": "5.00",
              "created_at": "2023-05-15 11:58:16",
              "updated_at": "2023-05-15 11:58:16",
              "deleted_at": null,
              "ability_name": "音阶",
              "sub_name": "音阶"
            },
            {
              "id": 10,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 2,
              "ability_id": 5,
              "value": "3.00",
              "created_at": "2023-05-15 11:58:16",
              "updated_at": "2023-05-15 11:58:16",
              "deleted_at": null,
              "ability_name": "琶音",
              "sub_name": "琶音"
            }
          ]
        ]
      },
      { // 数据同上
        "id": 3,
        "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
        "pet_nickname": "音乐宝贝",
        "pet_id": 1,
        "pet_level_id": 12,
        "flair_id": 1,
        "gender": 0,
        "memo": null,
        "created_at": "2023-05-15 17:44:43",
        "updated_at": "2023-05-15 18:03:26",
        "deleted_at": null,
        "pet_name": "蛋蛋兽",
        "english_abbr": "egg",
        "head_image": "http://static.doyure.com/dmapi/pets/01_dd_boy@2x.png",
        "img": "http://static.doyure.com/dmapi/pets/01_dd_boy@2x.png",
        "file_path": "http://static.doyure.com/dmapi/pets/01_dd_boy@2x.png",
        "flair_name": "普通",
        "level_name": "孵化体",
        "is_evolve": 0,
        "need_stone": "30.0",
        "need_ability": "5000.0",
        "abilities": [
          [
            {
              "id": 11,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 3,
              "ability_id": 1,
              "value": "11.00",
              "created_at": "2023-05-15 17:44:43",
              "updated_at": "2023-05-15 18:03:26",
              "deleted_at": null,
              "ability_name": "视奏单音",
              "sub_name": "单音"
            },
            {
              "id": 12,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 3,
              "ability_id": 2,
              "value": "10.00",
              "created_at": "2023-05-15 17:44:43",
              "updated_at": "2023-05-15 18:03:26",
              "deleted_at": null,
              "ability_name": "视奏连续音",
              "sub_name": "速音"
            },
            {
              "id": 13,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 3,
              "ability_id": 3,
              "value": "8.00",
              "created_at": "2023-05-15 17:44:43",
              "updated_at": "2023-05-15 18:03:26",
              "deleted_at": null,
              "ability_name": "手指灵活",
              "sub_name": "手指"
            },
            {
              "id": 14,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 3,
              "ability_id": 4,
              "value": "9.00",
              "created_at": "2023-05-15 17:44:43",
              "updated_at": "2023-05-15 18:03:26",
              "deleted_at": null,
              "ability_name": "音阶",
              "sub_name": "音阶"
            },
            {
              "id": 15,
              "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
              "user_pet_id": 3,
              "ability_id": 5,
              "value": "7.00",
              "created_at": "2023-05-15 17:44:43",
              "updated_at": "2023-05-15 18:03:26",
              "deleted_at": null,
              "ability_name": "琶音",
              "sub_name": "琶音"
            }
          ]
        ]
      }
    ],
    "abilities": [ // 学员能力
      {
        "id": 1, // 学员能力id
        "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
        "ability_id": 1, // 对应能力id
        "value": 1000, // 当前学员能力值
        "created_at": "2023-05-11 17:12:43",
        "updated_at": "2023-05-12 15:46:24",
        "deleted_at": null,
        "ability_name": "视奏单音", // 能力名称
        "sub_name": "单音", // 能力简称
        "pet_fight_total": 17, // 所有宠物附加值
        "pet_fight_markup": "25%", // 所有宠物战力加成
        "fight_subtotal": 1017 // 此项学员能力+宠物能力值
      },
      { // 同上
        "id": 2,
        "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
        "ability_id": 2,
        "value": 0,
        "created_at": "2023-05-11 17:12:43",
        "updated_at": "2023-05-11 17:12:47",
        "deleted_at": null,
        "ability_name": "视奏连续音",
        "sub_name": "速音",
        "pet_fight_total": 15,
        "fight_subtotal": 15
      },
      {
        "id": 3,
        "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
        "ability_id": 3,
        "value": 0,
        "created_at": "2023-05-11 17:12:43",
        "updated_at": "2023-05-11 17:12:47",
        "deleted_at": null,
        "ability_name": "手指灵活",
        "sub_name": "手指",
        "pet_fight_total": 14,
        "fight_subtotal": 14
      },
      {
        "id": 4,
        "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
        "ability_id": 4,
        "value": 0,
        "created_at": "2023-05-11 17:12:43",
        "updated_at": "2023-05-11 17:12:47",
        "deleted_at": null,
        "ability_name": "音阶",
        "sub_name": "音阶",
        "pet_fight_total": 14,
        "fight_subtotal": 14
      },
      {
        "id": 5,
        "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
        "ability_id": 5,
        "value": 0,
        "created_at": "2023-05-11 17:12:43",
        "updated_at": "2023-05-11 17:12:47",
        "deleted_at": null,
        "ability_name": "琶音",
        "sub_name": "琶音",
        "pet_fight_total": 10,
        "fight_subtotal": 10
      }
    ],
    "ability_ranking": "2", // 学员当前战力排名
    "pet_ability_total": 210934, // 宠物中战力值
    "user_ability_total": 852434, // 学员总能力值(加上宠物能力后)
    "user_fight_total": 1070, // 学员排位能力值
    "is_milestone": 1, // 是否开启里程碑
    "is_free_training": 1, // 是否开启自由练习
    "is_fight": 1, // 是否开启排位赛
    "new_startask_num": 8, // 新的星球任务数量
    "finish_startask_num": 0, // 已完成数量
    "startask_status": 1, //  星球状态:0无、1未完成、2已完成
    "is_startask": 1, // 是否开启星球任务
    "pet_use_gold": 10000, // 购买新宠物需消耗 究极币数量
    "ability_ranges": [5000, 15000, 25000, 35000, 50000, 70000], // 学员能力级别划分
    "ability_colors": ["#808080", "#7D6F91", "#795EA2", "#795EA2", "#9611EE", "#6600FF"], // 学员能力五维图颜色块
    "current_ability_level": 0, // 学员当前等级
    "next_ability_value": 10000, // 下一级能力值
    "user_avatar_urls": [], // 学员默认头像组选择
    "fight_stage": 3, // 排位赛当前段位
    "fight_score": 5, // 排位赛当前星级数
    "fight_stage": 30, // 排位赛当前分值
    "fight_score_subtotal": 100, // 排位赛当前段位总分
    "upgrade_type": "", // 晋级赛类型:空非晋级、star星级晋级赛、stage段位晋级赛
    "upgrade_num": 0, // 晋升次数
    "upgrade_win_num": 0, // 晋级获胜次数
    "upgrade_defeat_num": 0, // 晋级失败次数
    "due_daynum": 90, // 到期天数
    "notice_text": "音乐究极院将于2023年12月01日完成所有区合服计划,届时个人战力排名会变为全服排名,因此会影响大家当前名次,特此公告望各位知晓!",  // 首页公告
    "open_milestone": 0, // 是否开启里程碑,该字段废弃。让学员自主选择
    "milestone_tip": "你可以完成里程碑试炼后,再进入里程碑", // 试炼提示语
    "is_weekly_box": 0, // 周赛宝箱是否可领取,0表无宝箱、1表可领取宝箱
    "weekly_start_date": "2023-12-11 00:00:00", // 本周榜开始时间
    "weekly_end_date": "2023-12-17 23:59:59" // 本周榜结束时间
  },
  "msg": ""
}

错误列表

错误状态码错误描述信息
400ret=400,客户端参数错误或非法请求
404表示接口服务不存在
406ret=406,access_token令牌校验不通过
407ret=407,app_key权限不足,或未知应用
408ret=408,当前用户禁止使用,或用户未登录
500表示服务端内部错误

本文档生成时间:2025-12-26 15:27:21