小编bad*_*uck的帖子

我正在尝试为一个项目（用 Laravel 编写）编写 OpenAPI 文档，并在几个 API 点上苦苦挣扎。

一返回

{
    "active_options": {
        "1": {
            "name": "name1",
            "type": "type1"
        },
        "2": {
            "name": "name2",
            "type": "type2"
        },
        "3": {
            "name": "name3",
            "type": "type3"
        }
    },
    "server": {
        "url": "URL...",
        "settings1": "value"
    },
    "message": "Server settings retrieved."
}

我正在努力解决如何使用 l5-swagger 插件编写此注释。“1”、“2”、“3”是可选的，它们的任意组合都有效。

我想使用optionalProperties，但我不知道如何将它们组合在一起。

这是我得到的最接近的：

     *   @OA\Response(
     *     response=200,
     *     description="Settings",
     *     @OA\JsonContent(
     *       @OA\Property(property="options",
     *         @OA\Items(
     *            @OA\Property(property="name", type="string"),
     *            @OA\Property(property="type", type="string")
     *         )
     *       ),
     *     )
     *   ),

但示例生成的是这样的：

{ …