接口描述:

  • 获取账号列表。

请求 URL:

  • http|https://host/api/v1/admin/method/get.admin.list/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
account string max:80 carey 账号或昵称
group_id integer gt:0 1 所属用户组
status integer in:0,1 1 是否启用 0=禁用 1=启用
page_no integer gt:0 1 1 页码
page_size integer between:1,40 15 20 每页数量
order_type string in:asc,desc desc asc 排序方式
order_field string 见附属 A admin_id create_time 排序字段

附属 A:
in:admin_id,username,group_id,nickname,last_login,status,create_time,update_time

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 2 合计计数
items 类型 是否返回 示例值 描述
admin_id integer 1 账号编号
username string admin 账号
group_id integer 1 所属用户组
nickname string carey 昵称
head_pic string //host/head_pic.jpg 头像
last_login datetime 2018-04-22 00:23:00 最后登陆时间
last_ip string 127.0.0.1 最后登录ip
status integer 1 是否启用 0=禁用 1=启用
create_time datetime 2018-04-22 00:23:00 创建时间
update_time datetime 2018-04-22 01:56:55 更新时间
get_auth_group object [] 用户组对象
get_auth_group 类型 是否返回 示例值 描述
name string|null 超级管理员 名称
status integer|null 1 是否启用 0=禁用 1=启用

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "admin_id": 2,
  8. "username": "adminA",
  9. "group_id": 1,
  10. "nickname": "careyA",
  11. "head_pic": "//host/head_pic.jpg",
  12. "last_login": "",
  13. "last_ip": "",
  14. "status": 1,
  15. "create_time": "2018-04-22 00:24:30",
  16. "update_time": "2018-04-22 01:49:36",
  17. "get_auth_group": {
  18. "name": "超级管理员",
  19. "status": 1
  20. }
  21. },
  22. {
  23. "admin_id": 1,
  24. "username": "admin",
  25. "group_id": 1,
  26. "nickname": "carey",
  27. "head_pic": "//host/head_pic.jpg",
  28. "last_login": "",
  29. "last_ip": "",
  30. "status": 1,
  31. "create_time": "2018-04-22 00:23:00",
  32. "update_time": "2018-04-22 01:56:55",
  33. "get_auth_group": {
  34. "name": "超级管理员",
  35. "status": 1
  36. }
  37. }
  38. ],
  39. "total_result": 2
  40. }
  41. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。
文档更新时间: 2018-05-21 15:46