Files
juwan-backend/desc/api/review.api
T
zetaloop dd3cd24b70 Merge branch 'main-merge-base-a'
# Conflicts:
#	deploy/dev/docker-compose.yml
#	deploy/dev/envoy.yaml
#	desc/api/dispute.api
#	desc/api/review.api
#	desc/api/search.api
2026-04-25 05:42:42 +08:00

64 lines
1.3 KiB
Plaintext

syntax = "v1"
import "common.api"
type (
ReviewPathId {
Id int64 `path:"id"`
}
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 {
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)
}