2021-07-21项目实训后端第四周（1）

PC端-用户管理接口

请求示例：http://grandland.gl-data.com:14332/manage/usermanage/xxx

1. 获取所有用户的详细个人信息。

TODO:

获取所有用户的详细个人信息，用于页面展示

URL	method
/getalluser	GET

传入数据
无

请求的返回数据格式如下：

[
  {
    "activitynum": 0,
    "isblacklist": "string",
    "register_time": "2021-07-20T03:32:24.920Z",
    "repairnum": 0,
    "user_id": "string",
    "user_openid": "string",
    "username": "string"
  }
]

返回数据	类型	说明
user_openid	String	用户open_id
user_id	String	用户id
username	String	用户名
isblacklist	int	该用户是否在黑名单中
activitynum	int	该用户参加活动的数量
repairnum	int	该用户报修座位的数量
register_time	Date	该用户的注册时间

2. 根据user_openid获取用户信息

TODO:

根据user_openid获取用户信息

URL	method
/queryuserbyopenid	GET

传入数据	类型	说明
user_openid	String	用户的openid

请求的返回数据格式如下：

{
  "activitynum": 0,
  "isblacklist": "string",
  "register_time": "2021-07-21T11:50:59.963Z",
  "repairnum": 0,
  "user_id": "string",
  "user_openid": "string",
  "username": "string"
}

返回数据	类型	说明
user_openid	int	用户open_id
user_id	int	用户id
username	int	用户名
isblacklist	int	该用户是否在黑名单中
activitynum	int	该用户参加活动的数量
repairnum	int	该用户报修座位的数量
register_time	int	该用户的注册时间

PC端-黑名单管理接口

请求示例：http://grandland.gl-data.com:14332/manage/usermanage/xxx

1. 获取黑名单中的所有详细信息，用于页面展示

TODO:

*** 获取黑名单中的所有详细信息，用于页面展示***

URL	method
/getblacklist	GET

传入数据
无

请求的返回数据格式如下：

[
  {
    "act_id": "string",
    "act_ids": [
      0
    ],
    "isall": "string",
    "user_openid": "string",
    "username": "string"
  }
]

返回数据	类型	说明
user_openid	int	用户open_id
username	int	用户名
isall	int	该用户是否禁止参加所有活动
act_ids	String[]	用户被禁止参加的活动名列表
act_id	String	用户被禁止参加的活动id组成的字符串

2. 根据user_openid获取用户黑名单信息

TODO:

根据user_openid获取用户黑名单信息

URL	method
/queryblacklistbyopenid	GET

传入数据	类型	说明
user_openid	String	用户的openid

请求的返回数据格式如下：

{
    "act_id": "string",
    "act_ids": [
      0
    ],
    "isall": "string",
    "user_openid": "string",
    "username": "string"
  }

返回数据	类型	说明
user_openid	int	用户open_id
username	int	用户名
isall	int	该用户是否禁止参加所有活动
act_ids	String[]	用户被禁止参加的活动名列表
act_id	String	用户被禁止参加的活动id组成的字符串

3. 获取可选活动列表，供查看黑名单限制活动使用

TODO:

获取可选活动列表，供查看黑名单限制活动使用

URL	method
/getallactlist	GET

传入数据	类型	说明
user_openid	String	用户的openid

请求的返回数据格式如下：

[
  {
    "act_desc": "string",
    "act_end_time": "2021-07-21T12:49:36.659Z",
    "act_id": 0,
    "act_name": "string",
    "act_start_time": "2021-07-21T12:49:36.659Z",
    "pick_end_time": "2021-07-21T12:49:36.659Z",
    "pick_start_time": "2021-07-21T12:49:36.659Z",
    "qrcode": "string",
    "room_name": "string",
    "sign_in_time": "2021-07-21T12:49:36.659Z",
    "sign_out_time": "2021-07-21T12:49:36.659Z"
  }
]

返回数据	类型	说明
act_id	int	活动序号
act_name	String	活动名称
act_desc	String	活动描述
room_name	String	活动教室
act_start_time	Date	活动开始时间
act_end_time	Date	活动结束时间
pick_start_time	Date	选座开始时间
pick_end_time	Date	选座结束时间
sign_in_time	Date	签到开始时间
sign_out_time	Date	签到结束时间

4. 批量加入黑名单

TODO:

批量加入黑名单

URL	method
/addblacklist	POST

传入数据	类型	说明
user_openid	String[]	用户的openid列表
isall	int	是否禁止参加所有活动
act_ids	int[]	用户被禁止参加的活动id列表

返回值(String)	含义
success	加入黑名单成功
fail	加入黑名单失败

5. 移出黑名单

TODO:

单个移出黑名单

URL	method
/deleteblacklistbyopenid	POST

传入数据	类型	说明
user_openid	String	用户的openid

返回值(String)	含义
success	移出黑名单成功
fail	移出黑名单失败

6. 批量移出黑名单

TODO:

批量移出黑名单

URL	method
/freeblacklist	POST

传入数据	类型	说明
user_openid	String[]	用户的openid列表

返回值(String)	含义
success	移出黑名单成功
fail	移出黑名单失败