syntax = "v1" import "common.api" type ( Review { Id int64 `json:"id"` OrderId int64 `json:"orderId"` FromUserId int64 `json:"fromUserId"` FromUserName string `json:"fromUserName"` Rating int `json:"rating"` Content string `json:"content"` Sealed bool `json:"sealed"` CreatedAt string `json:"createdAt"` } ReviewListResp { Items []Review `json:"items"` Meta PageMeta `json:"meta"` } SubmitReviewReq { Rating int `json:"rating"` Content string `json:"content,optional"` } ) @server( prefix: api/v1 group: review ) service juwan-api { @doc "提交评价" @handler SubmitReview post /orders/:id/review (SubmitReviewReq) returns (EmptyResp) @doc "获取订单评价" @handler GetOrderReviews get /orders/:id/reviews (EmptyResp) returns ([]Review) } @server( prefix: api/v1 group: review ) service review-api { @doc "获取公开评价列表" @handler ListReviews get /reviews (PageReq) returns (ReviewListResp) @doc "获取用户收到的评价" @handler ListUserReviews get /users/:id/reviews (PageReq) returns (ReviewListResp) }