HTTP/HTTPS
请求协议
东梦接口平台 / 究极院APP-V3 / 获取学员信息
获取学员信息
接口地址:https://dmapi.v3.doyure.com/api/ultima.php?s=Ultima.User.UserInfo
接口描述: 试试刷新学员信息
接口参数
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|---|---|---|---|---|---|
| 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": ""
}错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400,客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406,access_token令牌校验不通过 |
| 407 | ret=407,app_key权限不足,或未知应用 |
| 408 | ret=408,当前用户禁止使用,或用户未登录 |
| 500 | 表示服务端内部错误 |
本文档生成时间:2025-12-26 15:27:21