openapi 1.1

server/app/Http/Controllers/V1/Rhawn/OrdersController.php

@@ -103,9 +103,49 @@ class OrdersController extends Controller
     }
 
     /**
-     * 获取订单详情
-     * @param Request $request
-     * @return \Illuminate\Http\JsonResponse|\Illuminate\Http\Resources\Json\JsonResource
+     * @Post(
+     *     path="/openapi/orders/getRhawnOrderDetail",
+     *     tags={"订单相关接口"},
+     *     summary="获取用户订单列表数据集",
+     *     description="订单列表",
+     *     @RequestBody(
+     *         @MediaType(
+     *             mediaType="application/json",
+     *             @Schema(
+     *                 required={"orderNumber"},
+     *                 @Property(property="orderNumber", @Schema(type="string"),description="订单编号"),
+     *                 example={"orderNumber" : 'XXXXXX'}
+     *             )
+     *         )
+     *     ),
+     *     @OA\Parameter(
+     *         description="用户获取的token值",
+     *         in="header",
+     *         name="authorization",
+     *         required=true,
+     *         @OA\Schema(type="string"),
+     *         @OA\Examples(example="authorization", value="bearerNWJiNDhkNzlmNjg0N2FlMmZiYjliZWM3NGVkNzIyMjNleUpsZUhCcGNtVWlPakUyTmpRMk1EazJORGNzSW1oaGMyZ2lPaUl5ZEhsc1JIQlhkWFpNUVdaWGJVRllJbjA9",summary=""),
+     *     ),
+     *     @AnnotationResponse(
+     *         response="200",
+     *         description="正常操作响应",
+     *         @MediaType(
+     *             mediaType="application/json",
+     *             @Schema(
+     *                 allOf={
+     *                     @Schema(ref="#/components/schemas/ApiResponse"),
+     *                     @Schema(
+     *                         type="object",
+     *                         @Property(property="data", ref="#/components/schemas/OrdersDetail")
+     *                     )
+     *                 }
+     *             )
+     *         )
+     *     ),
+     *     security={
+     *         {"bearer_token":{}}
+     *     }
+     * )
      */
     public function getCustomerOrderDetail(Request $request)
     {