add: some user api and all api desc

2026-02-27 19:17:01 +08:00
parent a0c720eb2f
commit 5930fb0dde
156 changed files with 9457 additions and 1086 deletions
@@ -0,0 +1,60 @@
+syntax = "v1"
+import "common.api"
+
+type (
+    Dispute {
+        Id          string   `json:"id"`
+        OrderId     string   `json:"orderId"`
+        Reason      string   `json:"reason"`
+        Status      string   `json:"status"`
+        Evidence    []string `json:"evidence"`
+        Result      string   `json:"result,optional"`
+        CreatedAt   string   `json:"createdAt"`
+    }
+
+    DisputeListResp {
+        Items []Dispute `json:"items"`
+        Meta  PageMeta  `json:"meta"`
+    }
+
+    CreateDisputeReq {
+        Reason   string   `json:"reason"`
+        Evidence []string `json:"evidence"`
+    }
+
+    DisputeResponseReq {
+        Reason   string   `json:"reason"`
+        Evidence []string `json:"evidence"`
+    }
+
+    AppealReq {
+        Reason string `json:"reason"`
+    }
+)
+
+@server(
+    prefix: api/v1
+    group: dispute
+    jwt: Auth
+)
+service juwan-api {
+    @doc "获取争议列表"
+    @handler ListDisputes
+    get /disputes (PageReq) returns (DisputeListResp)
+
+    @doc "获取订单争议"
+    @handler GetOrderDispute
+    get /orders/:id/dispute (EmptyResp) returns (Dispute)
+
+    @doc "发起争议"
+    @handler CreateDispute
+    post /orders/:id/dispute (CreateDisputeReq) returns (EmptyResp)
+
+    @doc "回应争议"
+    @handler RespondDispute
+    post /disputes/:id/response (DisputeResponseReq) returns (EmptyResp)
+
+    @doc "申诉"
+    @handler AppealDispute
+    post /disputes/:id/appeal (AppealReq) returns (EmptyResp)
+}