暂存提交

order/src/main/resources/openapi/order-v1.yaml

@@ -0,0 +1,67 @@
+openapi: 3.0.3
+info:
+  title: 柏悦头程订单 API
+  version: 1.1.0
+security:
+  - bearerAuth: []
+paths:
+  /api/merchant/v1/orders/first-leg:
+    post:
+      summary: 创建订单草稿
+      parameters:
+        - $ref: '#/components/parameters/IdempotencyKey'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        '200':
+          description: 创建成功或同请求重放成功，返回相同订单ID
+        '400':
+          description: 缺少或使用了无效幂等键
+        '409':
+          description: 相同幂等键对应不同请求或请求仍在处理中
+        '503':
+          description: 仓库或往来单位下游服务异常
+  /api/merchant/v1/orders/first-leg/{id}/submit:
+    post:
+      summary: 提交订单
+      parameters:
+        - $ref: '#/components/parameters/OrderId'
+        - $ref: '#/components/parameters/IdempotencyKey'
+      responses:
+        '200':
+          description: 提交成功或同请求重放成功
+        '400':
+          description: 缺少或使用了无效幂等键
+        '404':
+          description: 订单不存在
+        '409':
+          description: 幂等键冲突、请求处理中或订单状态冲突
+        '503':
+          description: 仓库或往来单位下游服务异常
+components:
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+  parameters:
+    OrderId:
+      name: id
+      in: path
+      required: true
+      schema:
+        type: integer
+        format: int64
+    IdempotencyKey:
+      name: Idempotency-Key
+      in: header
+      required: true
+      description: 同一租户和操作者重试同一请求时必须保持不变
+      schema:
+        type: string
+        minLength: 1
+        maxLength: 128