登录登出接口

编辑
  • 文档创建者:jiangsr
  • 浏览次数:5132次
  • 编辑次数:4次
  • 最近更新:dhc12912 于 2019-06-11
  • 1. 上次登录信息

    1.1 获取

    请求:GET  /login/info

    参数:无

    返回值:


    {
    data:{
    time:"",//上次登录时间
    ip:"",//登录 IP
    city:""//登录所在城市
    }
    }

    1.2 新增

    请求:POST /login/info

    参数:

      参数名参数值    说明
      ip  RequestBody 参数  登录 IP
      city  RequestBody 参数  登录城市

    返回值:


    {
    data:"success"
    }

    2. 登录

    请求:POST /login

    参数:

      参数名参数值  传输方式  
      username  用户名  明文
      password  密码  明文
      validity  有效期  -2——记住密码(默认 14 天)
      -1——关闭浏览器清除
      大于 0 为具体时间,单位秒

    返回值:


    //登录成功
    {"accessToken":"lajda7andjashk2jksdjsd","url":"https://www.fanruan.com/report/decision"}

    注:登录成功返回访问令牌及访问地址,访问令牌记录此登录会话的安全信息。


    //登录失败
    {"errorCode":11300007,"errorMsg":"Invalid username or password!"}

    3. 跨域登录

    请求:GET /login/cross/domain

    参数:

    参数名    参数值其他  
      fine_username  用户名  明文传输
      fine_password  密码  明文传输
      validity    有效期  -2-记住密码(默认 14 天);
      -1-关闭浏览器清除;
      大于 0 为具体时间,单位毫秒  
      callback  回调函数名  默认值为"callback"

    返回值:


    //登录成功
    callback({"accessToken":"lajda7andjashk2jksdjsd","url":"https://www.fanruan.com/report/decision"})


    //登录失败
    callback({"errorCode":11300007,"errorMsg":"Invalid username or password!"})

    4. 注销

    请求:POST /logout

    请求头:

      请求头名字  请求头值
      Authorization  Bearer lajda7andjashk2jksdjsd...

    参数:无

    返回值:

    {"staus":"success"}

    注:暂时还没有注销失败的情况,不考虑。

    5. 跨域注销

    请求:GET /logout/cross/domain

    请求头:

      请求头名字  请求头值
      Authorization  Bearer lajda7andjashk2jksdjsd

    参数:

      参数名参数值    其他
      callback  回调函数名  默认值为“callback”

    返回值:

    callback({"staus":"success"})

    注:暂时还没有注销失败的情况,不考虑。

    6. 登录相关

    6.1 获取登录配置项

    请求:GET /login/config

    参数:无

    返回值:


    {
    data: {
    singleLogin:true,
    singleLoginMode:1,
    showLastLoginedInfo:true,
    supportForgetPwd:true,
    smsRemind:true
    }
    }

    6.2 添加管理员账号密码

    请求:POST /login/admin

    参数:

    参数名  参数值    说明
      username  RequestBody 参数  管理员用户名
      password  RequestBody 参数  管理员密码

    返回值:


    {
    data:"success"
    }

    6.3 发送登录验证码

    请求:GET /login/captcha

    参数:

      参数名  参数值  说明
      username    RequestParam参数  用户名,可选
      type  RequestParam参数  接收器类型:mobile—手机 Email—邮箱
      receiver  RequestParam参数  验证码接收器号码
      token   RequestParam参数  登录获取的 Token,可选

    返回值:


    {
    data: {
    captchaSendToken:"" //发送验证码token
    }
    }

    6.4 校验登录验证码

    请求:PUT /login/captcha

    参数:

    参数名    参数值说明  
      captcha  RequestBody参数  验证码
      token    RequestBody参数  发送验证码后的 Token,必选

    返回值:


    {
    data: {
    captchaCheckToken:"" //校验验证码token
    }
    }

    6.5 根据验证码校验 Token 重置密码

    请求:PUT /login/pwd/resetting

    参数:

    参数名   参数值   说明
      newPassword  RequestBody 参数  密码,必选
      captchaToken  RequestBody 参数  验证使用的 Token

    返回值:


    {
    data: "success"
    }

    6.6 根据旧密码修改密码

    请求:POST /login/pwd/change

    参数:

      参数名参数值  说明  
      username  RequestBody 参数  用户名
      newPassword  RequestBody 参数  新密码
      oldPassword  RequestBody 参数  旧密码

    返回值:


    {
    data: "success"
    }

    6.7 根据用户名获取对应手机号

    请求:GET /login/mobile

    参数:

      参数名  参数值说明  
      username  RequestParam 参数  用户名

    返回值:


    {
    data: "124324132"
    }

    注:返回对应手机号。

    6.8 根据号码获取对应用户名列表

    请求:GET /login/usernames

    参数:

    参数名  参数值    说明
      receiver  RequestParam 参数  验证码接收器号码
      type  RequestParam 参数  接收器类型:mobile—手机 Email—邮箱

    返回值:


    {
    data: ["Alice","Jack","Anna"]
    }

    6.9 根据验证码登录

    请求:POST /login/captcha

    参数:

      参数名参数值    说明
      token  RequestBody 参数  验证码认证后获取的 Token

    返回值:

    {"accessToken":"lajda7andjashk2jksdjsd","url":"https://www.fanruan.com/report/decision"}



    附件列表


    主题: 部署集成
    标签: 暂无标签 编辑/添加标签
    如果您认为本文档还有待完善,请编辑

    文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
    关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
    若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

    此页面有帮助吗?只是浏览 [ 去社区提问 ]