一、新增评论
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 "
}
标签:请求,模块接口,number,响应,文档,评论,参数,id,String
From: https://www.cnblogs.com/xulingduo/p/18550392