东梦接口平台 / 究极院APP-V3 / 学员账号登录

学员账号登录

接口描述: 学员账号登录返回token信息和关联的学员组

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

接口参数

参数名字类型是否必须默认值其他说明
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": ""
}

错误列表

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

本文档生成时间:2025-12-26 15:28:01