1. 用户登录

用户登录接口：

POST:http://api.xdua.com/login

Content-Type:application/x-www-form-urlencoded

字段名 位置 类型 字段说明 可选
by body String 注册方式:tel:电话号码，mail：邮箱注册 必选
ustr body String 电话格式是+86-15810419011,邮箱是真实邮箱格式 必选
pwd body String 32位小写md5码 必选
shop body String 登录哪个店铺M5D码 必选
role body String 以什么角色登录,不设置网关会默认是,""表示以本用户的最大角色集合做这次登录 可选

[!NOTE|style:flat|label:Mylabel|iconVisibility:hidden] role字段是地球号登录灵活表达登录后效果的一种方式，它可以表达，尽管登录的人可能拥有好多角色，比方说root,god,shopa，但TA只想以某个角色子集进行登录，不想让暴露给客户端额外无意义的角色。例如，一个护理APP,用户登录时只想以护理或者院长的身份登录，并不像让护理APP或者TA还有本社区的超级管理员权限。此时就需要在role字段注明。

role举例 字段说明
* 以当前用户的最大权限集合登录，返回的roles是所有角色
None 仅仅以None角色登录，返回的是None角色列表就是["None"]。
*,None 如果有在role表达字串里，表达等效
None,god 以None和God角色登录
God 效果等同"God,None"。因为如果没有None,会自动补None

[!NOTE] 因为大多数用户都是普通注册用户，为他们维持在授角表的位置太浪费空间。所以普通注册用户仅仅在user表维持一席之地，并不在usro占据空间。

返回数据

字段名 类型 字段说明
user_id String 用户ID,8位大小写数字字母
token String 登录后的令牌,建议客户端在本地存储保存这个令牌，以便在接下来多次使用。
expire String 登录令牌的截至时间，UNIX时间。
roles JsonList 用户本次登录使用的角色列表
rules JsonList 用户本次登录使用的权限列表

成功返回

{
    "error": 0,
    "reason": "Success"
    "result": ["user_id"  =>用户的id,"token"  =>"返回的登陆token","role"=>"以逗号隔开的角色列表","rule"=>"以逗号隔开的权限列表"],
}

从登陆获得的token可以看到，这是一个XdUaXduA户群的用户Dt5mvrtU登录，这个用户在这个户群里有rot,god,none三个授权.

成功返回获取的dua_id要保存在本地更新掉旧有的dua_id。作为登录后的dua_id存在.

失败返回

{
    "error": 1,
    "reason": "失败原因"
    "result": {"失败返回的参考数据"},
}

results matching ""

    No results matching ""