. allOf нужен, чтобы расширять ApiResult. В data у меня может быть и список, и объект, например, или вообще null. * @OA\Response(
* response=200,
* description="ok",
* @OA\JsonContent(
* allOf = {
* @OA\Schema(ref="#/components/schemas/ApiResult")
* },
* @OA\Property(
* property = "success",
* type="boolean",
* example="true"
* ),
* @OA\Property(
* property = "data",
* ref="#/components/schemas/Item"
* )
* )
* ),/**
* @OA\Schema(
* schema="Item",
* description="Блабла",
* @OA\Property(property="id", type="integer", example=123),
* @OA\Property(property="name", type="string", example="Test"),
* @OA\Property(property="var", type="object", anyOf = {
* @OA\Schema(ref="#/components/schemas/Variant1"),
* @OA\Schema(ref="#/components/schemas/Variant2")
* })
* )
*/* @OA\Property(property="resp", type="object", anyOf = {
* @OA\Schema(ref="#/components/schemas/Variant1"),
* @OA\Schema(ref="#/components/schemas/Variant2")
* })
Эта генерация документации через аннотации не гарантирует соответствия примера схеме или же соответствия тому, что реально в вашем коде происходит. Это нужно рассматривать просто как некий инструмент для формирования OpenAPI по комментариям в коде. Следить за его актуальностью нужно самостоятельно. Но никто не мешает, кстати, написать OpenAPI вручную (я раньше так и делал) без этой библиотеки, но, на самом деле, в таком случае расхождений получается сильно много - и быстро теряется актуальность.