HTTP/HTTPS
请求协议
东梦接口平台 / 究极院APP-V3 / 学员账号登录
学员账号登录
接口地址:https://dmapi.v3.doyure.com/api/ultima.php?s=Ultima.UserLogin.Login
接口描述: 学员账号登录返回token信息和关联的学员组
接口参数
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|---|---|---|---|---|---|
| phone | 字符串 | 必须 | - | 登录手机号 | |
| code | 字符串 | 可选 | - | 验证码 | |
| password | 字符串 | 可选 | - | 登录密码 |
返回字段
| 返回结果 | 类型 | 说明 |
|---|---|---|
| ret | 整型 | 状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误 |
| data | 对象或混合类型 | 业务数据,由各自接口指定,通常为对象 |
| msg | 字符串 | 提示信息,失败时的错误提示 |
在线测试
| 参数 | 是否必须 | 值 |
|---|---|---|
| service | 必须 | |
| phone | 必须 | |
| code | 可选 | |
| password | 可选 |
客户端请求示例
{
"ret": 200,
"data": {
"token": "190ba3ccc2deffd3f727e0f939b37ac9d4401d25", // 登录token
"users": [ // 同一个手机号有多个账户
{ // 账户一
"id": 11471,
"uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
"telephone": "13456782949", // 手机号
"password": "aef1c5bb051c85c7913af39b521f9ccb",
"realname": "张云利", // 真实姓名
"nickname": "测试", // 昵称
"avatar": "https://static.doyure.com//dmapi/uploads/20230526/172805_c49fd676b9593cbcbb30db7c5541cf05.png", // 头像
"gender": 0,
"from": 2,
"start_level": 16,
"org_id": 1,
"inviter_id": 0,
"openid": "otTGr6H8d1H-NunLAN17u9bHJM-0",
"unionid": "olfY152T2k2pU-LnDDl2XDd9fOeY",
"ios_unionid": null,
"ability_total": "641500.0", // 学员真实战力
"pet": 213, // 默认显示的宠物id
"gold": "967924.0", // 究极币
"stone_num": "97996.0", // 进化石
"energy_num": "0.0",
"speed_up": "17000.00",
"game_rank": 3,
"group_type": 1,
"source_type": 1,
"source_id": 1,
"product_id": 0,
"source_name": "",
"start_date": "2023-08-05",
"due_date": "2035-01-01",
"worker_time": null,
"online_duration_day": "103.93",
"online_duration_total": "5367.00",
"created_at": "2022-05-27 16:56:02", // 创建时间
"add_gold": 0,
"teacher_uid": "1ce9d57b7f3cca6f9d015b75a89ef53b61232b59",
"is_eval": 0,
"babel_level": 24,
"is_locate": 1,
"pet_head": 1,
"user_pets": [ // 学员对应的宠物
{
"id": 341, // 学员宠物id,即为user_pet_id
"uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",
"pet_nickname": "音乐宝贝",
"pet_id": 3,
"pet_level_id": 16,
"flair_id": 3,
"gender": 2,
"basic_markup": "3.1,3.3,3.9,4,3,3.4,3.9,3.9", // 该宠物各项能力加成
"is_battle": 1,
"is_status": 0,
"memo": null,
"created_at": "2023-10-25 17:06:06",
"updated_at": "2023-12-28 16:52:37",
"deleted_at": null,
"pet_name": "蓝小鲸",
"english_abbr": "whale",
"flair_name": "杰出(SSR)",
"level_name": "青年体",
"need_evolve": "1.0",
"repay_stone": "50.00",
"repay_gold": "8000.00"
},
........
]
},
{ // 账户二
"id": 16965,
"uid": "1e051d7c66eb4d12c0ed5803f24bdbb39a148e7e",
"telephone": "13456782949",
"password": "",
"realname": "嗯嗯",
"nickname": "张奉天",
"avatar": "https://thirdwx.qlogo.cn/mmopen/vi_32/PiajxSqBRaEIP1qEK5ic0ysbvYGNf0rM0puwJhAnIwt5KHvGLWqoXibYwja52xDcBzocw6NwZycbXxUxJK5Fk0nQw/132",
"gender": 0,
"description": "",
"learn_material": 1,
"tunes": 1,
"album": 1,
"birthday": "2023-09-21",
"from": 2,
"school_time": "2022-06-01",
"school_age": 6,
"start_level": 0,
"org_id": 1,
"inviter_id": 0,
"openid": "otTGr6FnXbk3qHt3isc5PVCw4LZE",
"unionid": "olfY156ImxfRJ_2itn2o7qmMEgNA",
"ios_unionid": null,
"ability_total": "16000.0",
"pet": 47,
"gold": "0.0",
"stone_num": "1.0",
"energy_num": "0.0",
"speed_up": "0.00",
"game_rank": 99999,
"group_type": 1,
"source_type": 1,
"source_id": 1,
"product_id": 0,
"source_name": "",
"start_date": "2023-05-01",
"due_date": "2035-01-01",
"worker_time": null,
"online_duration_day": "0.00",
"online_duration_total": "0.00",
"created_at": "2022-12-22 17:53:54",
"updated_at": "2024-01-13 10:59:46",
"deleted_at": null,
"add_gold": 0,
"teacher_uid": "2aaaa4e172ecd95c7ad126fcceb44305f53ba864",
"is_eval": 0,
"babel_level": null,
"is_locate": 1,
"pet_head": 1
}
]
},
"msg": ""
}错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400,客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406,access_token令牌校验不通过 |
| 407 | ret=407,app_key权限不足,或未知应用 |
| 408 | ret=408,当前用户禁止使用,或用户未登录 |
| 500 | 表示服务端内部错误 |
本文档生成时间:2025-12-26 15:28:01