谷粒学院-田宏志

1 鸣谢

本次CSA Java培训收获良多，非常感谢我的组长李学长提供的帮助和耐心的指导，同时也非常感谢所有评委老师的建议和指导。

2 谷粒学院-在线教育项目

项目说明

谷粒学院，是一个B2C模式的职业技能在线教育系统，分为前台用户系统和后台运营平台。
使用了微服务架构，前后端分离开发，前端主要根据视频老师所敲，同时，后端自己做。

前台用户系统包括：首页、课程、名师、问答（前端存在问题）、文章。后台管理系统包括：讲师管理、课程分类管理、课程管理、统计分析、Banner管理、订单管理等功能。

前端主要使用了Vue、element-ui、Nust、echarts等技术
后端主要使用了SpringBoot（快速构建Spring项目的脚手架）、SpringCloud（Nacos注册中心、 feign注册与发现、Hystrix断路器、Gateway网关）、mybatisPlus、EasyExcel、阿里云OSS的视频点播与短信服务、Redis、HttpClient等技术，开发历经一个月左右的时间。
另外采用nginx进行反向代理

联系方式

• **联系人：**田宏志
• **邮箱：**1605292886@qq.com
• 网址：/https://blog.csdn.net/zhihong2002//

文档版本

1.0

3 课程管理前端

3.1 课程详情方法

GET /eduservice/coursefront/getCourseFrontInfo/{courseId}

地址参数（Path Variable）

参数名称	默认值	描述
courseId		courseId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

3.2 条件查询带分页的课程

POST /eduservice/coursefront/getCourseFrontList/{page}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
page		page

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
buyCountSort	string		false	销量排序
gmtCreateSort	string		false	最新时间排序
priceSort	string		false	价格排序
subjectId	string		false	二级类别id
subjectParentId	string		false	一级类别id
teacherId	string		false	讲师id
title	string		false	课程名称

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

3.3 根据课程id查询课程信息

POST /eduservice/coursefront/getCourseInfoOrder/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
avatar	string		false	讲师头像
buyCount	int32		false	销售数量
cover	string		false	课程封面图片路径
description	string		false	课程简介
id	string		false	课程id
intro	string		false	讲师资历,一句话说明讲师
lessonNum	int32		false	总课时
price	number		false	课程销售价格，设置为0则可免费观看
subjectLevelOne	string		false	类别一级名称
subjectLevelOneId	string		false	课程一级类别ID
subjectLevelTwo	string		false	类别二级名称
subjectLevelTwoId	string		false	课程二级类别ID
teacherId	string		false	讲师ID
teacherName	string		false	讲师姓名
title	string		false	课程标题
viewCount	int32		false	浏览数量

接口描述

4 课程分类

4.1 添加课程分类

POST /eduservice/subject/addSubject

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
file	string		false	file

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

4.2 课程分类列表

GET /eduservice/subject/getAllSubject

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

5 小节

5.1 添加小节

POST /eduservice/video/addVideo

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
chapterId	string		false	章节ID
courseId	string		false	课程ID
duration	number		false	视频时长（秒）
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	视频ID
isFree	boolean	false	false	是否可以试听：0收费 1免费
playCount	int32		false	播放次数
size	int32		false	视频源文件大小（字节）
sort	int32		false	排序字段
status	string		false	Empty未上传 Transcoding转码中 Normal正常
title	string		false	节点名称
version	int32		false	乐观锁
videoOriginalName	string		false	原始文件名称
videoSourceId	string		false	云端视频资源

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

5.2 删除小节

DELETE /eduservice/video/deleteVideo/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

5.3 根据小节id查询

GET /eduservice/video/getVideoInfo/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

5.4 修改小节

POST /eduservice/video/updateVideo

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
chapterId	string		false	章节ID
courseId	string		false	课程ID
duration	number		false	视频时长（秒）
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	视频ID
isFree	boolean	false	false	是否可以试听：0收费 1免费
playCount	int32		false	播放次数
size	int32		false	视频源文件大小（字节）
sort	int32		false	排序字段
status	string		false	Empty未上传 Transcoding转码中 Normal正常
title	string		false	节点名称
version	int32		false	乐观锁
videoOriginalName	string		false	原始文件名称
videoSourceId	string		false	云端视频资源

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

6 前端微信扫码登录

6.1 获取扫描人信息添加数据

GET /api/ucenter/wx/callback

请求参数(Query Param)

参数名称	默认值	描述
code		code
state		state

响应体

● 200 响应数据格式：JSON

接口描述

6.2 生成微信扫描二维码

GET /api/ucenter/wx/login

响应体

● 200 响应数据格式：JSON

接口描述

7 阿里云视频上传

7.1 删除多个阿里云视频

DELETE /eduvod/video/deleteBatch

请求参数(Query Param)

参数名称	默认值	描述
videoIdList		videoIdList

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

7.2 根据视频id获取视频凭证

GET /eduvod/video/getPlayAuth/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

7.3 根据视频id删除阿里云视频

DELETE /eduvod/video/removeAliyVideo/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

7.4 上传视频到阿里云

POST /eduvod/video/uploadAlyiVideo

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
file	string		false	file

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8 课程管理

8.1 添加课程基本信息

POST /eduservice/course/addCourseInfo

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
cover	string		false	课程封面图片路径
description	string		false	课程简介
id	string		false	课程ID
lessonNum	int32		false	总课时
price	number		false	课程销售价格，设置为0则可免费观看
status	string		false	课程状态 Draft未发布 Normal已发布
subjectId	string		false	二级分类ID
subjectParentId	string		false	一级分类ID
teacherId	string		false	课程讲师ID
title	string		false	课程标题

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.2 删除课程

POST /eduservice/course/deleteCourse/{courseId}

地址参数（Path Variable）

参数名称	默认值	描述
courseId		courseId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.3 根据课程查询课程基本信息

GET /eduservice/course/getCourseInfo/{courseId}

地址参数（Path Variable）

参数名称	默认值	描述
courseId		courseId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.4 课程列表

GET /eduservice/course/getCourseList

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.5 根据课程id查询课程确认信息

GET /eduservice/course/getPublishCourseInfo/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.6 条件查询带分页课程列表

POST /eduservice/course/pageCourseCondition/{current}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
current		当前页码

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
cover	string		false	课程封面图片路径
description	string		false	课程简介
id	string		false	课程ID
lessonNum	int32		false	总课时
price	number		false	课程销售价格，设置为0则可免费观看
status	string		false	课程状态 Draft未发布 Normal已发布
subjectId	string		false	二级分类ID
subjectParentId	string		false	一级分类ID
teacherId	string		false	课程讲师ID
title	string		false	课程标题

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.7 分页查询课程列表

POST /eduservice/course/pageListCourse/{current}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
current		当前页码

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.8 课程最终发布修改课程状态

POST /eduservice/course/publishCourse/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

8.9 根据id修改课程信息

POST /eduservice/course/updateCourseInfo

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
cover	string		false	课程封面图片路径
description	string		false	课程简介
id	string		false	课程ID
lessonNum	int32		false	总课时
price	number		false	课程销售价格，设置为0则可免费观看
status	string		false	课程状态 Draft未发布 Normal已发布
subjectId	string		false	二级分类ID
subjectParentId	string		false	一级分类ID
teacherId	string		false	课程讲师ID
title	string		false	课程标题

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

9 阿里云文件管理

9.1 文件上传

POST /eduoss/fileoss

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
file	string		false	文件

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

10 讲师管理

10.1 添加讲师列表

POST /eduservice/teacher/addTeacher

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
avatar	string		false	讲师头像
career	string		false	讲师资历,一句话说明讲师
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	讲师ID
intro	string		false	讲师简介
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
level	int32		false	头衔 1高级讲师 2首席讲师
name	string		false	讲师姓名
sort	int32		false	排序

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

10.2 所有讲师列表

GET /eduservice/teacher/findAll

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

10.3 根据id查询讲师

GET /eduservice/teacher/getTeacher/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		讲师ID

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

10.4 分页讲师列表

GET /eduservice/teacher/pageTeacher/{current}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
current		当前页码

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

10.5 条件查询带分页讲师列表

POST /eduservice/teacher/pageTeacherCondition/{current}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
current		当前页码

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
begin	string	2019-01-01 10:10:10	false	查询开始时间
end	string	2019-12-01 10:10:10	false	查询结束时间
level	int32		false	头衔 1高级讲师 2首席讲师
name	string		false	教师名称,模糊查询

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

10.6 更新讲师

POST /eduservice/teacher/updateTeacher

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
avatar	string		false	讲师头像
career	string		false	讲师资历,一句话说明讲师
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	讲师ID
intro	string		false	讲师简介
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
level	int32		false	头衔 1高级讲师 2首席讲师
name	string		false	讲师姓名
sort	int32		false	排序

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

10.7 逻辑删除讲师

DELETE /eduservice/teacher/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		讲师ID

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

11 章节

11.1 添加章节

POST /eduservice/chapter/addChapter

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
courseId	string		false	课程ID
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	章节ID
sort	int32		false	显示排序
title	string		false	章节名称

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

11.2 删除章节

DELETE /eduservice/chapter/deleteChapter/{chapterId}

地址参数（Path Variable）

参数名称	默认值	描述
chapterId		chapterId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

11.3 根据章节id查询

GET /eduservice/chapter/getChapterInfo/{chapterId}

地址参数（Path Variable）

参数名称	默认值	描述
chapterId		chapterId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

11.4 课程大纲列表

GET /eduservice/chapter/getChapterVideo/{courseId}

地址参数（Path Variable）

参数名称	默认值	描述
courseId		courseId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

11.5 修改章节

POST /eduservice/chapter/updateChapter

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
courseId	string		false	课程ID
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	章节ID
sort	int32		false	显示排序
title	string		false	章节名称

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

12 前台查询课程名师

12.1 查询前8条热门课程，查询前4条讲师

GET /eduservice/indexfront/index

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

13 讲师管理前端

13.1 讲师详情功能

GET /eduservice/teacherfront/getTeacherFrontInfo/{teacherId}

地址参数（Path Variable）

参数名称	默认值	描述
teacherId		teacherId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

13.2 分页查询所有讲师

POST /eduservice/teacherfront/getTeacherFrontList/{page}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
page		page

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

14 前端登录注册接口

14.1 查询某一天注册人数

GET /educenter/member/countRegister/{day}

地址参数（Path Variable）

参数名称	默认值	描述
day		day

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

14.2 根据token字符串获取用户信息

POST /educenter/member/getInfoUc/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
avatar	string		false	用户头像
id	string		false	会员id
nickname	string		false	昵称

接口描述

14.3 根据token获取用户信息

GET /educenter/member/getMemberInfo

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

14.4 根据用户id获取用户信息

POST /educenter/member/getUserInfoOrder/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
age	int32		false	年龄
avatar	string		false	用户头像
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	会员id
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
isDisabled	boolean	false	false	是否禁用 1（true）已禁用， 0（false）未禁用
mobile	string		false	手机号
nickname	string		false	昵称
openid	string		false	微信openid
password	string		false	密码
sex	int32		false	性别 1 女，2 男
sign	string		false	用户签名

接口描述

14.5 登录

POST /educenter/member/login

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
age	int32		false	年龄
avatar	string		false	用户头像
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	会员id
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
isDisabled	boolean	false	false	是否禁用 1（true）已禁用， 0（false）未禁用
mobile	string		false	手机号
nickname	string		false	昵称
openid	string		false	微信openid
password	string		false	密码
sex	int32		false	性别 1 女，2 男
sign	string		false	用户签名

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

14.6 注册

POST /educenter/member/register

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
code	string		false	验证码
mobile	string		false	手机号
nickname	string		false	昵称
password	string		false	密码

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

15 微信支付管理

15.1 生成微信支付二维码接口

GET /eduorder/paylog/createNative/{orderNo}

地址参数（Path Variable）

参数名称	默认值	描述
orderNo		orderNo

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

15.2 查询订单支付状态

GET /eduorder/paylog/queryPayStatus/{orderNo}

地址参数（Path Variable）

参数名称	默认值	描述
orderNo		orderNo

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

16 评论

16.1 分页查询所有评论

GET /eduservice/comment/getCommentList/{page}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
page		page

请求参数(Query Param)

参数名称	默认值	描述
courseId		courseId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

16.2 添加评论

POST /eduservice/comment/saveComment

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
avatar	string		false	会员头像
content	string		false	评论内容
courseId	string		false	课程id
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	评论ID
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
memberId	string		false	会员id
nickname	string		false	会员昵称
teacherId	string		false	讲师id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

17 查询支付订单模块

17.1 生成订单的方法

POST /eduorder/order/createOrder/{courseId}

地址参数（Path Variable）

参数名称	默认值	描述
courseId		courseId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

17.2 根据订单id查询订单信息

GET /eduorder/order/getOrderInfo/{orderId}

地址参数（Path Variable）

参数名称	默认值	描述
orderId		orderId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

17.3 根据课程id和用户id查询订单中订单状态

GET /eduorder/order/isBuyCourse/{courseId}/{memberId}

地址参数（Path Variable）

参数名称	默认值	描述
courseId		courseId

响应体

● 200 响应数据格式：JSON

接口描述

18 显示管理

18.1 info

GET /admin/acl/index/info

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

18.2 logout

POST /admin/acl/index/logout

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

18.3 getMenu

GET /admin/acl/index/menu

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19 用户管理

19.1 根据id列表删除管理用户

DELETE /admin/acl/user/batchRemove

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19.2 根据用户分配角色

POST /admin/acl/user/doAssign

请求参数(Query Param)

参数名称	默认值	描述
userId		userId
roleId		roleId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19.3 获取用户

GET /admin/acl/user/get/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19.4 删除管理用户

DELETE /admin/acl/user/remove/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19.5 新增管理用户

POST /admin/acl/user/save

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	会员id
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
nickName	string		false	昵称
password	string		false	密码
salt	string		false	用户头像
token	string		false	用户签名
username	string		false	微信openid

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19.6 根据用户获取角色数据

GET /admin/acl/user/toAssign/{userId}

地址参数（Path Variable）

参数名称	默认值	描述
userId		userId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19.7 修改管理用户

PUT /admin/acl/user/update

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	会员id
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
nickName	string		false	昵称
password	string		false	密码
salt	string		false	用户头像
token	string		false	用户签名
username	string		false	微信openid

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

19.8 获取管理用户分页列表

GET /admin/acl/user/{page}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
page		当前页码

请求参数(Query Param)

参数名称	默认值	描述
id		会员id
username		微信openid
password		密码
nickName		昵称
salt		用户头像
token		用户签名
isDeleted		逻辑删除 1（true）已删除， 0（false）未删除
gmtCreate		创建时间
gmtModified		更新时间

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

20 菜单管理

20.1 查询所有菜单

GET /admin/acl/permission

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

20.2 给角色分配权限

POST /admin/acl/permission/doAssign

请求参数(Query Param)

参数名称	默认值	描述
roleId		roleId
permissionId		permissionId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

20.3 递归删除菜单

DELETE /admin/acl/permission/remove/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

20.4 新增菜单

POST /admin/acl/permission/save

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
children	array[object]		false	下级
⇥ children	array		false	下级
⇥ component	string		false	组件路径
⇥ gmtCreate	string		false	创建时间
⇥ gmtModified	string		false	更新时间
⇥ icon	string		false	图标
⇥ id	string		false	编号
⇥ isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
⇥ level	int32		false	层级
⇥ name	string		false	名称
⇥ path	string		false	访问路径
⇥ permissionValue	string		false	权限值
⇥ pid	string		false	所属上级
⇥ select	boolean		false
⇥ status	int32		false	状态(0:禁止,1:正常)
⇥ type	int32		false	类型(1:菜单,2:按钮)
component	string		false	组件路径
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
icon	string		false	图标
id	string		false	编号
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
level	int32		false	层级
name	string		false	名称
path	string		false	访问路径
permissionValue	string		false	权限值
pid	string		false	所属上级
select	boolean		false
status	int32		false	状态(0:禁止,1:正常)
type	int32		false	类型(1:菜单,2:按钮)

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

20.5 根据角色获取菜单

GET /admin/acl/permission/toAssign/{roleId}

地址参数（Path Variable）

参数名称	默认值	描述
roleId		roleId

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

20.6 修改菜单

PUT /admin/acl/permission/update

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
children	array[object]		false	下级
⇥ children	array		false	下级
⇥ component	string		false	组件路径
⇥ gmtCreate	string		false	创建时间
⇥ gmtModified	string		false	更新时间
⇥ icon	string		false	图标
⇥ id	string		false	编号
⇥ isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
⇥ level	int32		false	层级
⇥ name	string		false	名称
⇥ path	string		false	访问路径
⇥ permissionValue	string		false	权限值
⇥ pid	string		false	所属上级
⇥ select	boolean		false
⇥ status	int32		false	状态(0:禁止,1:正常)
⇥ type	int32		false	类型(1:菜单,2:按钮)
component	string		false	组件路径
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
icon	string		false	图标
id	string		false	编号
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
level	int32		false	层级
name	string		false	名称
path	string		false	访问路径
permissionValue	string		false	权限值
pid	string		false	所属上级
select	boolean		false
status	int32		false	状态(0:禁止,1:正常)
type	int32		false	类型(1:菜单,2:按钮)

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

21 权限管理

21.1 根据id列表删除角色

DELETE /admin/acl/role/batchRemove

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

21.2 获取角色

GET /admin/acl/role/get/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

21.3 删除角色

DELETE /admin/acl/role/remove/{id}

地址参数（Path Variable）

参数名称	默认值	描述
id		id

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

21.4 新增角色

POST /admin/acl/role/save

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	角色id
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
remark	string		false	备注
roleCode	string		false	角色编码
roleName	string		false	角色名称

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

21.5 修改角色

PUT /admin/acl/role/update

请求体(Request Body)

参数名称	数据类型	默认值	不为空	描述
gmtCreate	string		false	创建时间
gmtModified	string		false	更新时间
id	string		false	角色id
isDeleted	boolean	false	false	逻辑删除 1（true）已删除， 0（false）未删除
remark	string		false	备注
roleCode	string		false	角色编码
roleName	string		false	角色名称

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

21.6 获取角色分页列表

GET /admin/acl/role/{page}/{limit}

地址参数（Path Variable）

参数名称	默认值	描述
page		当前页码

请求参数(Query Param)

参数名称	默认值	描述
id		角色id
roleName		角色名称
roleCode		角色编码
remark		备注
isDeleted		逻辑删除 1（true）已删除， 0（false）未删除
gmtCreate		创建时间
gmtModified		更新时间

响应体

● 200 响应数据格式：JSON

参数名称	类型	默认值	不为空	描述
code	int32		false	返回码
data	object		false	返回数据
message	string		false	返回消息
success	boolean	false	false	是否成功

接口描述

最后

以上就是暴躁黑猫为你收集整理的谷粒学院api文档谷粒学院-田宏志的全部内容，希望文章能够帮你解决谷粒学院api文档谷粒学院-田宏志所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。