php - 用于 PHP 数组的 Swagger

Question

我正在尝试创建一个应返回如下数组的响应示例：

[
  [
    "Shop Name",
    "53.7094190",
    "-1.9084720"
    ,1
  ]
]

为此，我正在使用以下代码：

*   @OA\Response(
*     response= "default",
*     description="Success: Array of shops",
*     @OA\MediaType(
*       mediaType="text/plain",
*         @OA\Schema(
*           type = "array",
*           @OA\Items( type="array",
*              @OA\Items(type="string", default="'Bridge Balti','53.7094190','-1.9084720',1"),
*           ),
*         )
*     )
*   )

我在招摇中心得到这个：

[
  [
    "string"
  ]
]

Answer 1

如果你只是想在 swagger ui 中显示一个示例，那么你需要使用“example”参数。

@OA\Items(type="string",example="'Bridge Balti','53.7094190','-1.9084720',1")