查询角色列表

接口描述:

接口地址:/admin/roles

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型
categoryId	分类id	query	false	integer
tagId	标签id	query	false	integer
current	当前页码	query	true	integer
size	显示数量	query	true	integer
keywords	搜索内容	query	true	string
isDelete	是否删除	query	false	integer
isDraft	草稿状态	query	false	integer
startTime	开始时间	query	false	string
endTime	结束时间	query	false	string

响应示例:

{
	"code": 0,
	"data": [
		{
			"id": 0,
			"roleName": ""
		}
	],
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	array	UserRoleDTO
flag	boolean
message	string

schema属性说明

UserRoleDTO

参数名称	参数说明	类型	schema
id		integer(int32)
roleName		string

响应状态:

状态码	说明	schema
200	OK	Result«List«UserRoleDTO»»
401	Unauthorized
403	Forbidden
404	Not Found

删除角色

接口描述:

接口地址:/admin/roles

请求方式：DELETE

consumes:["application/json"]

produces:["*/*"]

请求示例：

[
	0
]

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
roleIdList	roleIdList	body	true	array	integer

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
204	No Content
401	Unauthorized
403	Forbidden

查询用户角色选项

接口描述:

接口地址:/admin/users/role

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：暂无

响应示例:

{
	"code": 0,
	"data": [
		{
			"id": 0,
			"roleName": ""
		}
	],
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	array	UserRoleDTO
flag	boolean
message	string

schema属性说明

UserRoleDTO

参数名称	参数说明	类型	schema
id		integer(int32)
roleName		string

响应状态:

状态码	说明	schema
200	OK	Result«List«UserRoleDTO»»
401	Unauthorized
403	Forbidden
404	Not Found

用户账号模块

查看后台用户列表

接口描述:

接口地址:/admin/users

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型
categoryId	分类id	query	false	integer
tagId	标签id	query	false	integer
current	当前页码	query	true	integer
size	显示数量	query	true	integer
keywords	搜索内容	query	true	string
isDelete	是否删除	query	false	integer
isDraft	草稿状态	query	false	integer
startTime	开始时间	query	false	string
endTime	结束时间	query	false	string

响应示例:

{
	"code": 0,
	"data": {
		"count": 0,
		"recordList": [
			{
				"avatar": "",
				"createTime": "",
				"id": 0,
				"ipAddr": "",
				"ipSource": "",
				"isDisable": 0,
				"lastLoginTime": "",
				"loginType": 0,
				"nickname": "",
				"roleList": [
					{
						"id": 0,
						"roleName": ""
					}
				],
				"status": 0,
				"userInfoId": 0
			}
		]
	},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	PageDTO«UserBackDTO»	PageDTO«UserBackDTO»
flag	boolean
message	string

schema属性说明

PageDTO«UserBackDTO»

参数名称	参数说明	类型	schema
count		integer(int32)
recordList		array	UserBackDTO

UserBackDTO

参数名称	类型	schema
avatar	string
createTime	string(date-time)
id	integer(int32)
ipAddr	string
ipSource	string
isDisable	integer(int32)
lastLoginTime	string(date-time)
loginType	integer(int32)
nickname	string
roleList	array	UserRoleDTO
status	integer(int32)
userInfoId	integer(int32)

UserRoleDTO

参数名称	参数说明	类型	schema
id		integer(int32)
roleName		string

响应状态:

状态码	说明	schema
200	OK	Result«PageDTO«UserBackDTO»»
401	Unauthorized
403	Forbidden
404	Not Found

修改管理员密码

接口描述:

接口地址:/admin/users/password

请求方式：PUT

consumes:["application/json"]

produces:["*/*"]

请求示例：

{
	"newPassword": "",
	"oldPassword": ""
}

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
passwordVO	密码	body	true	PasswordVO	PasswordVO

schema属性说明

PasswordVO

参数名称	参数说明	in	是否必须	数据类型	schema
newPassword	新密码	body	true	string
oldPassword	旧密码	body	true	string

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

用户注册

接口描述:

接口地址:/users

请求方式：POST

consumes:["application/json"]

produces:["*/*"]

请求示例：

{
	"code": "",
	"password": "",
	"username": ""
}

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
user	用户注册	body	true	UserVO	UserVO

schema属性说明

UserVO

参数名称	参数说明	in	是否必须	数据类型
code	邮箱验证码	body	true	string
password	密码	body	true	string
username	用户名	body	true	string

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

发送邮箱验证码

接口描述:

接口地址:/users/code

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求示例：

null

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
username	用户名	body	true	String	String

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
401	Unauthorized
403	Forbidden
404	Not Found

qq登录

接口描述:

接口地址:/users/oauth/qq

请求方式：POST

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
openId	openId	body	true	String	String
accessToken	accessToken	body	true	String	String

响应示例:

{
	"code": 0,
	"data": {
		"accountNonExpired": true,
		"accountNonLocked": true,
		"articleLikeSet": [],
		"authorities": {},
		"avatar": "",
		"browser": "",
		"commentLikeSet": [],
		"credentialsNonExpired": true,
		"email": "",
		"enabled": true,
		"id": 0,
		"intro": "",
		"ipAddr": "",
		"ipSource": "",
		"lastLoginTime": "",
		"loginType": 0,
		"nickname": "",
		"os": "",
		"password": "",
		"roleList": [],
		"userInfoId": 0,
		"username": "",
		"webSite": ""
	},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	UserInfoDTO	UserInfoDTO
flag	boolean
message	string

schema属性说明

UserInfoDTO

参数名称	类型	schema
accountNonExpired	boolean
accountNonLocked	boolean
articleLikeSet	array
authorities	Collection«GrantedAuthority»	Collection«GrantedAuthority»
avatar	string
browser	string
commentLikeSet	array
credentialsNonExpired	boolean
email	string
enabled	boolean
id	integer(int32)
intro	string
ipAddr	string
ipSource	string
lastLoginTime	string(date-time)
loginType	integer(int32)
nickname	string
os	string
password	string
roleList	array
userInfoId	integer(int32)
username	string
webSite	string

Collection«GrantedAuthority»

参数名称	参数说明	类型	schema

响应状态:

状态码	说明	schema
200	OK	Result«UserInfoDTO»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

微博登录

接口描述:

接口地址:/users/oauth/weibo

请求方式：POST

consumes:["application/json"]

produces:["*/*"]

请求示例：

null

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
code	code	body	true	String	String

响应示例:

{
	"code": 0,
	"data": {
		"accountNonExpired": true,
		"accountNonLocked": true,
		"articleLikeSet": [],
		"authorities": {},
		"avatar": "",
		"browser": "",
		"commentLikeSet": [],
		"credentialsNonExpired": true,
		"email": "",
		"enabled": true,
		"id": 0,
		"intro": "",
		"ipAddr": "",
		"ipSource": "",
		"lastLoginTime": "",
		"loginType": 0,
		"nickname": "",
		"os": "",
		"password": "",
		"roleList": [],
		"userInfoId": 0,
		"username": "",
		"webSite": ""
	},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	UserInfoDTO	UserInfoDTO
flag	boolean
message	string

schema属性说明

UserInfoDTO

参数名称	类型	schema
accountNonExpired	boolean
accountNonLocked	boolean
articleLikeSet	array
authorities	Collection«GrantedAuthority»	Collection«GrantedAuthority»
avatar	string
browser	string
commentLikeSet	array
credentialsNonExpired	boolean
email	string
enabled	boolean
id	integer(int32)
intro	string
ipAddr	string
ipSource	string
lastLoginTime	string(date-time)
loginType	integer(int32)
nickname	string
os	string
password	string
roleList	array
userInfoId	integer(int32)
username	string
webSite	string

Collection«GrantedAuthority»

参数名称	参数说明	类型	schema

响应状态:

状态码	说明	schema
200	OK	Result«UserInfoDTO»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

修改密码

接口描述:

接口地址:/users/password

请求方式：PUT

consumes:["application/json"]

produces:["*/*"]

请求示例：

{
	"code": "",
	"password": "",
	"username": ""
}

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
user	用户注册	body	true	UserVO	UserVO

schema属性说明

UserVO

参数名称	参数说明	in	是否必须	数据类型
code	邮箱验证码	body	true	string
password	密码	body	true	string
username	用户名	body	true	string

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

用户信息模块

修改用户禁用状态

接口描述:

接口地址:/admin/users/disable/{userInfoId}

请求方式：PUT

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
userInfoId	userInfoId	path	true	integer
isDisable	isDisable	query	false	integer

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

查看在线用户

接口描述:

接口地址:/admin/users/online

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型
categoryId	分类id	query	false	integer
tagId	标签id	query	false	integer
current	当前页码	query	true	integer
size	显示数量	query	true	integer
keywords	搜索内容	query	true	string
isDelete	是否删除	query	false	integer
isDraft	草稿状态	query	false	integer
startTime	开始时间	query	false	string
endTime	结束时间	query	false	string

响应示例:

{
	"code": 0,
	"data": {
		"count": 0,
		"recordList": [
			{
				"avatar": "",
				"browser": "",
				"ipAddr": "",
				"ipSource": "",
				"lastLoginTime": "",
				"nickname": "",
				"os": "",
				"userInfoId": 0
			}
		]
	},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	PageDTO«UserOnlineDTO»	PageDTO«UserOnlineDTO»
flag	boolean
message	string

schema属性说明

PageDTO«UserOnlineDTO»

参数名称	参数说明	类型	schema
count		integer(int32)
recordList		array	UserOnlineDTO

UserOnlineDTO

参数名称	参数说明	类型	schema
avatar		string
browser		string
ipAddr		string
ipSource		string
lastLoginTime		string(date-time)
nickname		string
os		string
userInfoId		integer(int32)

响应状态:

状态码	说明	schema
200	OK	Result«PageDTO«UserOnlineDTO»»
401	Unauthorized
403	Forbidden
404	Not Found

下线用户

接口描述:

接口地址:/admin/users/online/{userInfoId}

请求方式：DELETE

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
userInfoId	userInfoId	path	true	integer

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
204	No Content
401	Unauthorized
403	Forbidden

修改用户角色

接口描述:

接口地址:/admin/users/role

请求方式：PUT

consumes:["application/json"]

produces:["*/*"]

请求示例：

{
	"nickname": "",
	"roleIdList": [],
	"userInfoId": 0
}

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
userRoleVO	用户权限	body	true	UserRoleVO	UserRoleVO

schema属性说明

UserRoleVO

参数名称	参数说明	in	是否必须	数据类型
nickname	昵称	body	false	string
roleIdList	角色id集合	body	false	array
userInfoId	用户信息id	body	false	integer(int32)

响应示例:

{
	"code": 0,
	"data": "",
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	string
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result«string»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

修改用户头像

接口描述:

接口地址:/users/avatar

请求方式：POST

consumes:["multipart/form-data"]

produces:["*/*"]

请求示例：

null

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
file	用户头像	body	true	MultipartFile	MultipartFile

响应示例:

{
	"code": 0,
	"data": "",
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	string
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result«string»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

绑定用户邮箱

接口描述:

接口地址:/users/email

请求方式：POST

consumes:["application/json"]

produces:["*/*"]

请求示例：

{
	"code": "",
	"email": ""
}

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
emailVO	绑定邮箱	body	true	EmailVO	EmailVO

schema属性说明

EmailVO

参数名称	参数说明	in	是否必须	数据类型	schema
code	邮箱验证码	body	true	string
email	用户名	body	true	string

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

修改用户资料

接口描述:

接口地址:/users/info

请求方式：PUT

consumes:["application/json"]

produces:["*/*"]

请求示例：

{
	"intro": "",
	"nickname": "",
	"webSite": ""
}

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
userInfoVO	用户信息对象	body	true	UserInfoVO	UserInfoVO

schema属性说明

UserInfoVO

参数名称	参数说明	in	是否必须	数据类型
intro	介绍	body	false	string
nickname	昵称	body	false	string
webSite	个人网站	body	false	string

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

博客信息模块

查看博客信息

接口描述:

接口地址:/

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：暂无

响应示例:

{
	"code": 0,
	"data": {
		"articleCount": 0,
		"avatar": "",
		"categoryCount": 0,
		"intro": "",
		"nickname": "",
		"notice": "",
		"tagCount": 0,
		"viewsCount": ""
	},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	BlogHomeInfoDTO	BlogHomeInfoDTO
flag	boolean
message	string

schema属性说明

BlogHomeInfoDTO

参数名称	参数说明	类型	schema
articleCount		integer(int32)
avatar		string
categoryCount		integer(int32)
intro		string
nickname		string
notice		string
tagCount		integer(int32)
viewsCount		string

响应状态:

状态码	说明	schema
200	OK	Result«BlogHomeInfoDTO»
401	Unauthorized
403	Forbidden
404	Not Found

查看关于我信息

接口描述:

接口地址:/about

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：暂无

响应示例:

{
	"code": 0,
	"data": "",
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	string
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result«string»
401	Unauthorized
403	Forbidden
404	Not Found

查看后台信息

接口描述:

接口地址:/admin

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：暂无

响应示例:

{
	"code": 0,
	"data": {
		"articleCount": 0,
		"avatar": "",
		"categoryCount": 0,
		"intro": "",
		"nickname": "",
		"notice": "",
		"tagCount": 0,
		"viewsCount": ""
	},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	BlogHomeInfoDTO	BlogHomeInfoDTO
flag	boolean
message	string

schema属性说明

BlogHomeInfoDTO

参数名称	参数说明	类型	schema
articleCount		integer(int32)
avatar		string
categoryCount		integer(int32)
intro		string
nickname		string
notice		string
tagCount		integer(int32)
viewsCount		string

响应状态:

状态码	说明	schema
200	OK	Result«BlogHomeInfoDTO»
401	Unauthorized
403	Forbidden
404	Not Found

修改关于我信息

接口描述:

接口地址:/admin/about

请求方式：PUT

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
aboutContent	aboutContent	query	false	string

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

查看公告

接口描述:

接口地址:/admin/notice

请求方式：GET

consumes:["application/json"]

produces:["*/*"]

请求参数：暂无

响应示例:

{
	"code": 0,
	"data": "",
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	string
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result«string»
401	Unauthorized
403	Forbidden
404	Not Found

修改公告

接口描述:

接口地址:/admin/notice

请求方式：PUT

consumes:["application/json"]

produces:["*/*"]

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
notice	notice	query	false	string

响应示例:

{
	"code": 0,
	"data": {},
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	object
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

上传语音

接口描述:

接口地址:/voice

请求方式：POST

consumes:["application/json"]

produces:["*/*"]

请求示例：

null

请求参数：

参数名称	参数说明	in	是否必须	数据类型	schema
type	消息类型	query	true	integer
userId	用户id	query	true	integer
nickname	用户昵称	query	true	string
avatar	用户头像	query	true	string
content	聊天内容	query	true	string
createTime	创建时间	query	true	string
ipAddr	用户登录ip	query	true	string
ipSource	ip来源	query	true	string
file	语音文件	body	true	MultipartFile	MultipartFile

响应示例:

{
	"code": 0,
	"data": "",
	"flag": true,
	"message": ""
}

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	string
flag	boolean
message	string

响应状态:

状态码	说明	schema
200	OK	Result«string»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

blog2

查询角色列表

删除角色

查询用户角色选项

用户账号模块

查看后台用户列表

修改管理员密码

用户注册

发送邮箱验证码

qq登录

微博登录

修改密码

用户信息模块

修改用户禁用状态

查看在线用户

下线用户

修改用户角色

修改用户头像

绑定用户邮箱

修改用户资料

博客信息模块

查看博客信息

查看关于我信息

查看后台信息

修改关于我信息

查看公告

修改公告

上传语音