评论模块接口文档
一、新增评论
1、基本信息:
请求路径:/comment
请求方式:PUT
接口描述:该接口用于用户对商家进行评论
2、请求参数:
请求参数格式:application/x-www-form-urlencoded
参数名称 | 说明 | 类型 | 是否必须 | 备注 |
---|---|---|---|---|
store_id | 商家ID | number | 是 | |
commentary | 评论内容 | String | 是 |
3、请求样例:
{
"store_id":1,
"commentary":"他卖的都是假货"
}
4、响应数据:
响应类型:applicaytion/json
响应参数说明:
参数名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 是 | 响应码,0-成功,1-失败 | ||
message | String | 否 | 提示信息 | ||
data | String | 否 | 返回的数据 |
响应数据样例:
{
"code": 0,
"massage": "操作成功",
"data": "当前时间: 09:34:34.266720300 来自于 MiniShopping "
}
二、查询评论
1、基本信息:
请求路径:/comment/search
请求方式:GET
接口描述:该接口用于商家或用户查询评论
2、请求参数:
请求参数格式:params
参数名称 | 说明 | 类型 | 是否必须 | 备注 |
---|---|---|---|---|
user_id | 用户ID | number | 否 | |
store_id | 商家ID | number | 否 |
3、请求样例:
~/comment?store_id=1&pageNum=1&pageSize=1
4、响应数据:
响应类型:applicaytion/json
响应参数说明:
参数名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 是 | 响应码,0-成功,1-失败 | ||
message | String | 否 | 提示信息 | ||
data | String | 否 | 返回的数据 |
响应数据样例:
{
"code": 0,
"massage": "操作成功",
"data": {
"total": 3,
"list": [
{
"id": 2,
"user_id": 1,
"store_id": 1,
"commentary": "他卖的都是假货",
"create_time": "2024-11-17 09:34:31",
"update_time": "2024-11-17 09:34:31"
}
]
}
}
三、评论删除
1、基本信息:
请求路径:/comment
请求方式:DELETE
接口描述:该接口用于用户删除评论
2、请求参数:
请求参数格式:application/x-www-form-urlencoded
参数名称 | 说明 | 类型 | 是否必须 | 备注 |
---|---|---|---|---|
id | 评论主键ID | number | 是 |
3、请求样例:
~/comment?id=2
4、响应数据:
响应类型:applicaytion/json
响应参数说明:
参数名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 是 | 响应码,0-成功,1-失败 | ||
message | String | 否 | 提示信息 | ||
data | String | 否 | 返回的数据 |
响应数据样例:
{
"code": 0,
"massage": "操作成功",
"data": "当前时间: 11:58:12.472482600 来自于 MiniShopping "
}
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 分享一个免费、快速、无限量使用的满血 DeepSeek R1 模型,支持深度思考和联网搜索!
· 基于 Docker 搭建 FRP 内网穿透开源项目(很简单哒)
· ollama系列01:轻松3步本地部署deepseek,普通电脑可用
· 25岁的心里话
· 按钮权限的设计及实现