用于 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"),
*           ),
*         )
*     )
*   )

我在 swagger hub 中得到了这个：

[
  [
    "string"
  ]
]

Answer 1

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

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

Answer 2

接受的答案对我不起作用。它不是数组，而是显示为字符串。 跟随改变对我有用。 （双引号有魔力）

example="[""Bridge Balti"",""53.7094190"",""-1.9084720"",1]"