文 档 中 心 / Document Center
搜索 管理中心
壹川接口文档V3
用户帐号登录
更新时间:2018-04-10 17:29:20   更新人员:叶洋   文档状态:完成 #18    测试接口
摘要
通过用户账号和密码登录系统。
  1. 接口基本信息
    接口名称:用户登录
    请求方法:POST
    接口地址:user/login
    登录验证:否
  2. 请求头参数
    参数名 参数 数据类型 是否必须 示例值 说明
    device-identy 设备标识 string anroid 使用接口的设备,可用值为:web|ios|android|wap,不传时默认为web
  3. 请求参数
    参数名 参数 数据类型 是否必须 示例值 说明
    username 用户名 string JayChou 登录时使用的用户名,一般为英文
    password 密码 string(32) e10adc3949ba59abbe56e057f20f883e 用户密码,需要使用md5方式在本地加密一次再传递
    only_driver 仅许司机登录 int 设置值为1时仅许司机登录,不设则不限制
  4. 响应头参数
    参数名 参数 数据类型 示例值 说明
    Access-Token 用户token string 92e4525a4f6b5318b7683a624275d736e01df7f5 用户身份token,登录成功响应头内参数
  5. 响应数据参数
    参数名 参数 数据类型 示例值 说明
    id 用户id int 2 用户唯一标识码
    ucode 用户编号 string u1000000 用户编号UCODE
    cid 所在公司机构id int 归属于哪家组织机构
    role 用户角色 int 用户角色代码 9为个人用户
    username 用户名 string
    nickname 昵称 string
    head 头像 string 用户头像图片hash值
    sex 性别 int 用户性别标识 1为男 2为女
    email 邮箱 email 用户电子邮箱,可用于找回密码
    tel 联系电话 tel
    qq 用户QQ号 string
    birthday 生日 string
  6. 请求示例
    接口请求:
    apirq('member/login', {
        method: "post",
        data: {
            "username": 'JayChou',
            "password": 'e10adc3949ba59abbe56e057f20f883e'
        }
    }) 
    
    # 成功返回
    {
        "code": 0,
        "msg": "登录成功!",
        "time": "1510292953",
        "data": {
            "id": 1,
            "ucode": "u1000000",
            "cid": 1,
            "role": 0,
            "username": "admini",
            "status": 1,
            "nickname": "超级管理员",
            "head": "83cbb1e1a048ff3453b00bfb64b83b0736639bb0",
            "sex": null,
            "email": "549042814@qq.com",
            "mobile": "18200509877",
            "tel": null,
            "device_token": null,
            "invite_code": "",
            "invite_code_from": "",
            "reg_ip": null,
            "reg_time": null,
            "login": 407,
            "last_login_ip": 2130706433,
            "last_login_time": 1510131815,
            "uid": 1,
            "name": "超级管理员",
            "initials": "cjgly",
            "birthday": null,
            "qq": null,
            "friend_group": null,
            "friend_list": null,
            "extra": null,
            "role_text": ""
        }
    }
    
    # 登录失败返回
    {
        "code": 1,
        "msg": "登录失败:帐号不存在或者被禁用",
        "time": "1510306949",
        "data": ""
    }
    
    # 签名错误返回
    {
        "code": 10006,
        "msg": "数据签名效验错误",
        "time": "1510306887",
        "data": ""
    }
    
    注意:请求时如果携带请求头用户token会先验证token是否已经登录,若已经登录则会显示用户已经登录了。另外使用不同的设备参数得到的token不可共用。
  7. 其它说明
    如果用户设备不是在PC端使用,那么用户登录时用的设备标识,也需要保存在本地,在后续的接口调用中,也要传递同样的设备标识。
本书创建于 2018-03-30 12:03:13 ?如有疑问,请联系技术人员