Как сопоставить этот массив json in swagger ui?

Question

Я работаю над чванством UI в PHP и я пытаюсь отобразить JSON как ниже

{ 
    "category": { 
    "id": 0, 
    "name": "string" 
    } 
} 

Я попробовал его с чванством Ui демок, но не может получить отображение как выше JSON, как можно Я получаю это json mapping, что бы было аннотация для этого? пожалуйста, помогите

Мой класс развязность является

/** 
    * @SWG\Definition(@SWG\Xml(name="MyFl")) 
    */ 
    class MyFl 
    { 

     /** 
    * @SWG\Property(format="int64") 
    * @var int 
    */ 
    public $id; 

    /** 
    * @SWG\Property(example="doggie") 
    * @var string 
    */ 
    public $name; 

    /** 
    * @SWG\Property(type="Category") 
    */ 
    public $category; 

    } 

И мой пост апи аннотация:

/** 
    * @SWG\Post(
    * path="/docs/fl", 
    * tags={"MY"}, 
    * summary="Insert fl info", 
    * operationId="FL", 
    * produces={"application/xml","application/json"}, 
    * @SWG\Parameter(in="body",name="body",description="Insert fl info",required=true,@SWG\Schema(ref="#/definitions/MyFl") 
    * ), 
    * @SWG\Response(response="default", description="successful operation") 
    *) 
    */ 

И это я получаю модель схемы, как:

Но я хочу JSON схемы, как:

{ 
     "category": { 
     "id": 0, 
     "name": "string" 
     } 
    } 

Пожалуйста, помогите мне ..

Answer 1

ОТВЕТСТВЕННОСТИ: Это было долгое время, так как я работал с чванством-PHP аннотаций, так что я Не уверен, что это лучший способ сделать это. Мой опыт больше в JSON Schema, а не в swagger-php.

Ваша структура данных фактически представляет собой два объекта. Первый - это объект с одним свойством: «категория». Тогда значение «категория» - это другой объект с двумя свойствами: «id» и «name». Я уверен, что вам нужно смоделировать их как два отдельных объекта.

/** 
* @SWG\Definition(@SWG\Xml(name="MyFl")) 
*/ 
class MyFl 
{ 

    /** 
    * @SWG\Property(type=Category) <-- Don't know if this is the right way to reference another schema. You will have to check the documentation. 
    */ 
    public $category; 

} 

---

/** 
* @SWG\Definition(@SWG\Xml(name="Category")) 
*/ 
class Category 
{ 

    /** 
    * @SWG\Property(format="int64") 
    * @var int 
    */ 
    public $id; 

    /** 
    * @SWG\Property(example="doggie") 
    * @var string 
    */ 
    public $name; 

} 

Надежда, что помогает.