Array with strings and subarrays

[vladgelevera]

I need to create the following structure:

"sections": [
  "slider",
  {
    "productsBlock": 9
  },
  "products"
]

I tried to create a Property with empty property key, but it ends up with error Multiple @OA\Property() with the same property="":

@OA\Property(
    property="sections",
    type="array",
    title="Category sections.",
    @OA\Items(
        @OA\Property(
            type="string",
            title="Slider.",
            example="slider",
        ),
        @OA\Property(
            property="productsBlock",
            type="integer",
            title="Block ID with products and banners.",
            example="9",
        ),
        @OA\Property(
            type="string",
            title="Products and filters.",
            example="products",
        ),
    ),
),

Also I tried to make Items through example like this:

@OA\Property(
    property="sections",
    type="array",
    title="Category sections.",
    @OA\Items(),
    example="['slider', {'productBlock': 9}, 'products']",
),

But it ends up being just a string.

"sections": "[`slider`, {`productBlock`: 9}, `products`]"

Is there any way to create the structure I need? Thank you!

[razumnyak]

Like that ?

/**
 * @OA\Schema(
 *   schema="Sections",
 *   type="array",
 *   @OA\Items(
 *     oneOf={
 *       @OA\Schema(type="string", enum={"slider", "products"}),
 *       @OA\Schema(ref="#/components/schemas/ProductsBlock")
 *     }
 *   )
 * )
 */

/**
 * @OA\Schema(
 *   schema="ProductsBlock",
 *   type="object",
 *   required={"productsBlock"},
 *   @OA\Property(
 *     property="productsBlock",
 *     type="integer",
 *     description="Количество продуктов в блоке"
 *   )
 * )
 */