Swagger OpenAPI 使用带有模式的对象而不是数组

Question

我正在使用 L5 Swagger来自 DarkOnLine使用 OpenApi 原理图生成 Swagger 文档。

使用模式我可以做

@OA\Property(property="certification", type="array", @OA\Items(ref="#/components/schemas/Certification"))

它工作得很好，显示为

"certification": [
    {
      "certification_id": 0,
      "name": "string"
    }
  ],

.但是它创建了一个带有方括号的数组块，里面有多个对象。

如何使用相同的工作但丢失数组。就像是

@OA\Property(property="certification", type="object", @OA\Items(ref="#/components/schemas/Certification")),

以便删除方括号并仅显示对象。

"certification": {
      "certification_id": 0,
      "name": "string"
 }

Answer 1

你可以做:

@OA\Property(
  property="certification", 
  ref="#/components/schemas/Certification"
)

@OA\Items注释仅在您想要指定数组内的属性时使用(请参阅 Data Types: array )。

在您的情况下，您只想描述一个对象，因此您只需在属性中引用对象的架构并删除 @OA\Items .