Swagger PHP: как объявить свойство для использования определения схемы?

Ответ моего приложения выглядит следующим образом:

{
"status": "success",
"data": {
"status": "ready"},
"request_id": "string"}

Я пытался определить ответ в Swagger

 *           @SWG\Response (
*              response=200,
*              description="Success response",
*              @SWG\Schema (
*                  @SWG\Property(
*                      property="status",
*                      type="string",
*                      default="success"*                  ),
*                  @SWG\Property(
*                      property="data",
*                      @SWG\Schema(
*                          ref="#/definitions/Service/models/Status"*                      )
*                  ),
*                  @SWG\Property(
*                      property="request_id",
*                      type="string"*                  ),
*              )
*          ),

Но он не использует определение схемы для статуса, поэтому мой ответ выглядит так:

{
"status": "success",
"data": {},
"request_id": "string"}

Как определить свойство данных для использования определения схемы? Или это можно сделать по-другому?

9

Решение

Как забавно может быть тот факт, что люди иногда находят ответ сразу после публикации вопроса.

Ответ:

*           @SWG\Response (
*              response=200,
*              description="Success response",
*              @SWG\Schema (
*                  @SWG\Property(
*                      property="status",
*                      type="string",
*                      default="success"*                  ),
*                  @SWG\Property(
*                      property="data",
*                      ref="#/definitions/Service/models/Status"*                  ),
*                  @SWG\Property(
*                      property="request_id",
*                      type="string"*                  ),
*              )
*          ),
10

Другие решения

Других решений пока нет …

По вопросам рекламы [email protected]