PythonWeb全栈开发项目式教程（慕课版）-API接口文档 红影赏析API接口文档

红影赏析API接口文档V1.0作者：段仕浩2024.6.10

目录TOC\o"1-1"\h\u3043一、用户注册API接口 331364二、用户登录API接口 319239三、图片显示API接口 421788四、电影导航API接口 43918五、电影推荐API接口 513681六、电影搜索API接口 528175七、轮播图API接口 61939八、查询用户信息API接口 625503九、电影列表信息API接口 715776十、电影作品信息API接口 828000十一、电影评价API接口 819526十二、影评展示API接口 911984十三、影评发表API接口 1027760十四、影评评价API接口 106922十五、头像上传API接口 1121304十六、用户修改API接口 1112137十七、我的影评API接口 1223191十八、密码重置API接口 12

用户注册API接口功能说明用户注册API接口调用路径http://ip地址:端口/api/user/registerHTTP请求方式POST请求数据类型application/json参数名类型长度描述必须unamevarchar登录账号■upwdvarchar登录密码■nikenamevarchar昵称avatarvarchar头像sexvarchar性别phonevarchar电话返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■样例参数JSON{

"uname":"xiaobai",

"upwd":"123456",

"nikename":"小白",

"avatar":"xb.jpg",

"sex":"男",

"phone":}返回JSON{"code":"200","msg":"操作成功！"}用户登录API接口功能说明用户登录API接口调用路径http://ip地址:端口/api/user/loginHTTP请求方式POST请求数据类型application/json参数名类型长度描述必须unamevarchar登录账号■upwdvarchar登录密码■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■tokenvarchar返回token信息，用户身份验证与赋权■样例参数JSON{

"uname":"xiaobai",

"upwd":"123456"}返回JSON{

"code":"200","msg":"操作成功！","token":"eyJhbGciOiJIUzUxMiJ9……"}图片显示API接口功能说明图片显示API接口调用路径http://ip地址:端口/api/image/display/<string:type>/<string:filename>HTTP请求方式GET请求数据类型application/x-www-form-urlencoded参数名类型长度描述必须typevarchar图片类型（cls或head）■filenamevarchar图片名称■请求示例:5000/api/image/display/cls/gj.jpg返回数据类型image/jpg电影导航API接口功能说明“首页”电影导航API接口调用路径http://ip地址:端口/api/films/get-filmtypesHTTP请求方式GET请求数据类型application/x-www-form-urlencoded返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回电影类型列表■样例参数无返回JSON{

"code":"200","msg":"操作成功！","data":[{"cover":"gmcq.jpg","name":"革命传奇","remark":null,"tid":1},]}电影推荐API接口功能说明“首页”电影推荐API接口调用路径http://ip地址:端口/api/films/recommend-films/<int:num>HTTP请求方式GET请求数据类型application/x-www-form-urlencoded参数名类型长度描述必须numint查询的电影的数量■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回电影列表■样例请求示例:5000/api/films/recommend-films/6返回JSON{

"code":"200","msg":"操作成功！","data":[{"cover":"gmcq.png","name":"革命传奇","tid":1,

"films":[{"fid":1

"title":"林海雪原",}],

},]}电影搜索API接口功能说明“首页”电影搜索API接口调用路径http://ip地址:端口/api/films/seach-filmsHTTP请求方式POST请求数据类型application/json参数名类型长度描述必须keywordvarchar查询的关键字■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回电影列表■样例参数JSON{"keyword":"关"}返回JSON{

"code":"200","msg":"操作成功！","data":[{

"tid":1,

"title":"林海雪原",

},]}轮播图API接口功能说明轮播图API接口调用路径http://ip地址:端口/api/films/seach-carousels/<int:num>HTTP请求方式GET请求数据类型application/x-www-form-urlencoded参数名类型长度描述必须numint查询的电影的数量■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回电影列表■样例请求示例:5000/api/films//seach-carousels/6返回JSON{

"code":"200","msg":"操作成功！","data":[{

"tid":1,

"title":"林海雪原",

},]}查询用户信息API接口功能说明查询用户信息API接口调用路径http://ip地址:端口/api/user/get-userHTTP请求方式GET请求数据类型application/x-www-form-urlencoded返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回用户信息■样例参数无返回JSON{

"code":"200","msg":"操作成功！","data":{"uid":1,"uname":"xiaobai","upwd":"123456""avatar":"xiaobai.jpg"}}电影列表信息API接口功能说明电影列表信息API接口调用路径http://ip地址:端口/api/films/get-films/<int:tid>HTTP请求方式GET请求数据类型application/x-www-form-urlencoded参数名类型长度描述必须tidint电影类型编号■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回电影列表■样例请求示例:5000/api/films/get-films/1返回JSON{

"code":"200","msg":"操作成功！","data":[{"cover":"gmcq.png","name":"革命传奇","tid":1,

"films":[{"fid":1

"title":"林海雪原",}]

}}电影作品信息API接口功能说明电影作品信息API接口调用路径http://ip地址:端口/api/films/get-film/<int:fid>HTTP请求方式GET请求数据类型application/x-www-form-urlencoded参数名类型长度描述必须fidint电影作品编号■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回电影作品信息■样例请求示例:5000/api/films/get-film/6返回JSON{

"code":"200","msg":"操作成功！","data":{"fid":1

"title":"林海雪原","director":"刘沛然",}}电影评价API接口功能说明电影评价API接口调用路径http://ip地址:端口/api/films/judge-filmHTTP请求方式POST请求数据类型application/json参数名类型长度描述必须fidint电影作品编号■starint评价的星级（1-5）■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■样例参数JSON{

"fid":1,"star":5}返回JSON{"code":"200","msg":"操作成功！"}影评展示API接口功能说明影评展示API接口调用路径http://ip地址:端口/api/films/get-discuss/<int:fid>HTTP请求方式GET请求数据类型application/x-www-form-urlencoded参数名类型长度描述必须fidint电影作品编号■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■dataarray返回电影评论列表■样例参数无返回JSON{

"code":"200","msg":"操作成功！","data":[

{

"did":1,

"comment":"我喜欢！",

"lowcount":0,

"topcount":0,

"user":{

"uid":1,

"uname":"xiaobai",

"avatar":"tx.png",

"nikename":"小白",

}

},}影评发表API接口功能说明影评发表API接口调用路径http://ip地址:端口/api/films/pub-discussHTTP请求方式POST请求数据类型application/json参数名类型长度描述必须fidint电影作品编号■commentvarchar影评内容■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■样例参数JSON{

"fid":1,"comment":"情节细腻，值得一看！"}返回JSON{"code":"200","msg":"操作成功！"}影评评价API接口功能说明影评评价API接口调用路径http://ip地址:端口/api/films/judge-discussHTTP请求方式POST请求数据类型application/json参数名类型长度描述必须didint影评编号■toplowint评价标志（0-踩，1-顶）■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■样例参数JSON{

"did":1,"toplow":0}返回JSON{"code":"200","msg":"操作成功！"}头像上传API接口功能说明头像上传API接口调用路径http://ip地址:端口/api/user/uploadHTTP请求方式POST请求数据类型application/x-www-form-urlencoded参数名类型长度描述必须filefile头像图片（png,gif,jpg,webp,jpeg格式）■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■upFilevarchar返回头像图片名称■样例参数file:4.jpg返回JSON{

"code":"200",

"msg":"上传成功！",

"upFile":"776321f3-59b8-4db1-ac8c-0e5b166494f4.jpg"}用户修改API接口功能说明用户修改API接口调用路径http://ip地址:端口/api/user/update-userHTTP请求方式POST请求数据类型application/json参数名类型长度描述必须nikenamevarchar昵称■avatarvarchar头像■sexvarchar性别■phonevarchar电话■返回数据类型application/json参数名类型长度描述必须codevarchar状态码，200正确，其他错误■msgvarchar返回消息内容■样例参数JSON{

"nikename":"小李子",

"avatar":"7eeafa31-eaf0-4160-ae2e-6a29649ae593.jpeg",

"sex":"男",

"phone":}返回JSON{"code":"200","msg":"操作成功！"}我的影评API接口功能说明我的影评API接口调用路径http://ip地址:端口/api/films/get-mydiscus