Как добавить массив к параметру в swagger yii2?

Question

Как добавить описания таких параметров в тело в запросе в swagger (yii2).

Composer require

"yii2mod / yii2-swagger": "*"

Я пытаюсь написать метод в API, используя swagger

Вот что он возвращает:

{
"parent_id":"",
"name":"testCategory3",
"position":"0",
"status":"1",
"publish-status":"1",
"charsName":["1","2","3"]
}

Мое описание:

   /**
     * @SWG\Put(path="/api/createCategory",
     *     tags={"Category"},
     *     summary="Create Category",
     *     @SWG\Parameter(
     *         name="Authorization",
     *         in="header",
     *         description=" ID",
     *         required=true,
     *         type="string"
     *     ),
     *     @SWG\Parameter(
     *         name="body",
     *         in="body",
     *         required=true,
     *         @SWG\Schema(
     *             type="object",
     *             @SWG\Property(property="parent_id", type="integer" ),
     *             @SWG\Property(property="status", type="integer" ),
     *             @SWG\Property(property="publish-status", type="integer" ),
     *             @SWG\Property(property="position", type="integer" ),
     *             @SWG\Property(property="name", type="string" ),
     *         )
     *     ),
     *     @SWG\Response(
     *         response = 200,
     *         description = "Ok",
     *         @SWG\Schema(ref = "#/")
     *     ),
     *     @SWG\Response(
     *         response = 400,
     *         description = "Bad Request",
     *         @SWG\Schema(ref = "#/")
     *     ),
     *     @SWG\Response(
     *         response = 404,
     *         description = "Not Found",
     *         @SWG\Schema(ref = "#/")
     *     ),
     *     @SWG\Response(
     *         response = 500,
     *         description = "Internal Server Error"
     *     )
     * )
     */

Как добавить массив charsName?

На странице Swagger

Answer 1

Свойство массива определяется с использованием type="array" и @SWG\Items:

     *             @SWG\Property(
     *               property="charsName",
     *               type="array",
     *               @SWG\Items(type="string"),
     *               example={"1","2","3"}
     *             )