跳到主要内容

评论 (review)

此模块负责创建评价、查询评价列表与物品评分汇总。

1. 创建评价 [POST]​

接口描述：用户对订单/物品进行评价，需登录，传入 assetId、订单、评分、内容等。

项目说明
云函数名review
HTTP 路由不适用
动作类型 (Action)createReview

1.1 请求参数 (Parameters)​

参数名类型必选默认值描述示例
assetIdString是-物品 ID“asset_xxx”
orderIdString是-订单 ID“order_xxx”
ratingNumber是-评分5
contentString否-评价内容“很好”

其余见 README 2.2 通用约定。

1.2 响应数据 (Response)​

成功时返回评价 ID 等，见通用约定。

1.3 错误码 (Error Codes)​

见 通用报错码。重复评价为 RH00601。

1.4 示例 (Examples)​

{
  "action": "createReview",
  "data": {
    "assetId": "asset_xxx",
    "orderId": "order_xxx",
    "rating": 5,
    "content": "很好"
  }
}

2. 获取物品评价列表 [GET]​

接口描述：根据 assetId 分页获取物品的评价列表。

项目说明
云函数名review
HTTP 路由不适用
动作类型 (Action)getReviews

2.1 请求参数 (Parameters)​

参数名类型必选默认值描述示例
assetIdString是-物品 ID“asset_xxx”
pageInteger否1页码1
pageSizeInteger否20每页条数20

2.2 响应数据 (Response)​

成功时 data 含 list、total 等，见通用约定。

2.3 错误码 (Error Codes)​

见 通用报错码。

2.4 示例 (Examples)​

{
  "action": "getReviews",
  "data": { "assetId": "asset_xxx", "page": 1, "pageSize": 20 }
}

3. 获取物品评分汇总 [GET]​

接口描述：获取物品的平均分、评价数量等汇总信息。

项目说明
云函数名review
HTTP 路由不适用
动作类型 (Action)getAssetRating

3.1 请求参数 (Parameters)​

参数名类型必选默认值描述示例
assetIdString是-物品 ID“asset_xxx”

3.2 响应数据 (Response)​

成功时返回平均分、数量等，见通用约定。

3.3 错误码 (Error Codes)​

见 通用报错码。

3.4 示例 (Examples)​

{
  "action": "getAssetRating",
  "data": { "assetId": "asset_xxx" }
}