接口描述:

  • 获取账号列表。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
user_level_id integer gt:0 1 账号等级编号
group_id integer gt:0 3 所属用户组
account string max:80 carey 账号、昵称、手机号
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 user_id create_time 排序字段

附属 A:
in:user_id,username,mobile,nickname,sex,birthday,user_level_id,status,create_time,total_money,balance,lock_balance,points,lock_points,name,discount

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 12 合计计数
items 类型 是否返回 示例值 描述
user_id integer 17 账号编号
username string carey 账号
mobile number 13071297155 手机号
is_mobile integer 0 手机号是否验证 0=否 1=是
email string admin@admin.cn 邮箱
is_email integer 0 邮箱是否验证 0=否 1=是
nickname string carey 昵称
head_pic string //host/head_pic.jpg 头像
sex integer 0 性别 0=保密 1=男 2=女
birthday date 1997-11-20 生日
user_level_id integer 1 账号等级编号
user_address_id integer 1 默认收货地址编号
group_id integer 3 所属用户组
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-23 13:12:22 创建时间
update_time datetime 2018-04-23 16:28:45 更新时间
get_user_level object [] 账号等级对象
get_user_money object [] 账号资金对象
get_user_level 类型 是否返回 示例值 描述
name string|null 普通会员 账号等级名称
discount integer|null 90 账号折扣额
get_user_money 类型 是否返回 示例值 描述
total_money number 100.05 累计消费
balance number 99.9 可用余额
lock_balance number 0.1 锁定余额
points number 100 账号积分
lock_points number 0 锁定积分

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "user_id": 17,
  8. "username": "carey",
  9. "mobile": "13071297155",
  10. "is_mobile": 1,
  11. "email": "",
  12. "is_email": 0,
  13. "nickname": "carey",
  14. "head_pic": "//host/head_pic.jpg",
  15. "sex": 1,
  16. "birthday": "1997-11-20",
  17. "user_level_id": 0,
  18. "user_address_id": 0,
  19. "group_id": 3,
  20. "last_login": "",
  21. "last_ip": "",
  22. "status": 1,
  23. "create_time": "2018-04-23 13:12:22",
  24. "update_time": "2018-04-23 16:28:45",
  25. "get_user_level": {
  26. "name": null,
  27. "discount": null
  28. },
  29. "get_user_money": {
  30. "total_money": 0,
  31. "balance": 1,
  32. "lock_balance": 0,
  33. "points": 0,
  34. "lock_points": 0
  35. }
  36. },
  37. {
  38. "user_id": 16,
  39. "username": "Dnyz520888",
  40. "mobile": "15867430655",
  41. "is_mobile": 1,
  42. "email": "",
  43. "is_email": 0,
  44. "nickname": "",
  45. "head_pic": "",
  46. "sex": 0,
  47. "birthday": "",
  48. "user_level_id": 1,
  49. "user_address_id": 0,
  50. "group_id": 3,
  51. "last_login": "",
  52. "last_ip": "",
  53. "status": 1,
  54. "create_time": "",
  55. "update_time": "",
  56. "get_user_level": {
  57. "name": "普通会员",
  58. "discount": 100
  59. },
  60. "get_user_money": {
  61. "total_money": 0,
  62. "balance": 0,
  63. "lock_balance": 0,
  64. "points": 0,
  65. "lock_points": 0
  66. }
  67. }
  68. ],
  69. "total_result": 12
  70. }
  71. }

备注:

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