接口文档

获取普通用户列表

更新时间：2018-04-16 12:04:02 更新人员：叶洋

文档状态：完成 #138 测试接口

章节导航器

接口基本信息
请求参数
响应数据参数
请求示例

摘要
获取普通用户列表

接口基本信息

接口名称：获取普通用户列表数据
请求方法：GET
接口地址：user/ct
登录验证：是

请求参数

参数名	参数	数据类型	是否必须	示例值	说明
page	页数	int	否	1	列表分页时传递的页码数，1代表第1页
row	每页条数	int	否	30	分布列表数据每一页显示多少条，默认15
username	用户名	string	否		参数进行模糊匹配到用户名
nickname	昵称	string	否		参数模糊匹配用户昵称
phone	电话号码	string	否		参数模糊匹配电话号码
email	邮件地址	string	否		参数模糊匹配用户绑定的邮件地址
sex	性别	int	否		参数匹配性别
role	角色	string	否		参数匹配用户角色

响应数据参数

参数名	参数	数据类型	示例值	说明
uid	用户UID	string	cd280d8e7351918d
code	用户代码	string	U8252376
utype	用户类型	int	1	用户类型为0时，代表个人用户，非0时代表有组织
username	用户名	string	acebn
status	状态	int	1	用户状态，1为正常，0为禁用
nickname	用户昵称	string
head	用户头像	string		图片对应的id值
sex	用户性别	int	1	性别
email	用户邮箱	string		邮箱是可以用于发送系统通知、验证码等功能的
mobile	手机号码	string		用户手机可用于接收业务通知、验证码等信息
tel	座机电话	string
invite_code	邀请码	string	5336AEAC	每个用户会自动生成一个邀请码，通过邀请码加入的其它用户会携带邀请者的标识
invite_code_from	邀请来自	string
reg_ip	注册IP	string	127.0.0.1	该用户的注册IP地址
reg_time	注册时间	string	2017-12-11 16:43:31
login	登录次数	int	39	统计该用户登录系统的总次数
last_login_ip	最后一次登录的IP	string	182.150.27.156
last_login_time	最后一次登录的时间	string	2018-01-23 09:18:42
realname	真实姓名	string	古力伊	用户真实姓名
realname_initials	姓名拼音首字母	string	gly	用于输入字母时可以实时索检
birthday	生日	string
qq	QQ号	string
ua	用户登录UA标识	string		应该标识内容包含有用户的操作系统，设备类型，浏览器类型等信息
remark	备注	string		用户的备注信息

请求示例

请求例子：

 
apirq('user/ct')

返回数据结果：

 
{
    "code": 0,
    "msg": "ok",
    "time": "1523851073",
    "data": {
        "page": 1,
        "row": 15,
        "count": 1,
        "total_count": 1,
        "total_page": 1,
        "lists": [
            {
                "uid": "1000000000000000",
                "code": "U0000001",
                "utype": 0,
                "orgid": "",
                "username": "iuser",
                "status": 1,
                "nickname": "系统内建普通用户",
                "head": "",
                "sex": 0,
                "email": "",
                "mobile": "",
                "tel": "",
                "invite_code": "",
                "invite_code_from": "",
                "reg_ip": "0.0.0.0",
                "reg_time": "1970-01-01 08:00:00",
                "login": 0,
                "last_login_ip": "0.0.0.0",
                "last_login_time": "1970-01-01 08:00:00",
                "realname": "",
                "realname_initials": "",
                "birthday": "",
                "qq": "",
                "ua": "",
                "remark": "",
                "delete_time": null,
                "orginfo": []
            }
        ]
    }
}