Files
juwan-backend/desc/api/review.api
T
2026-05-03 05:58:21 +08:00

65 lines
1.3 KiB
Plaintext

syntax = "v1"
import "common.api"
type (
ReviewPathId {
Id int64 `path:"id"`
}
Review {
Id int64 `json:"id,string"`
OrderId int64 `json:"orderId,string"`
FromUserId int64 `json:"fromUserId,string"`
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 {
ReviewPathId
Rating int `json:"rating"`
Content string `json:"content,optional"`
}
GetOrderReviewsReq {
ReviewPathId
}
ListUserReviewsReq {
ReviewPathId
PageReq
}
)
@server (
prefix: api/v1
group: review
)
service review-api {
@doc "提交评价"
@handler SubmitReview
post /orders/:id/review (SubmitReviewReq) returns (EmptyResp)
@doc "获取订单评价"
@handler GetOrderReviews
get /orders/:id/reviews (GetOrderReviewsReq) returns (ReviewListResp)
}
@server (
prefix: api/v1
group: review
)
service review-api {
@doc "获取公开评价列表"
@handler ListReviews
get /reviews (PageReq) returns (ReviewListResp)
@doc "获取用户收到的评价"
@handler ListUserReviews
get /users/:id/reviews (ListUserReviewsReq) returns (ReviewListResp)
}