Swagger PHP: come dichiarare la proprietà per utilizzare la definizione dello schema? La risposta di

Question

My App si presenta così:

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

ho cercato di definire la risposta in 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" 
*     ), 
*    ) 
*   ), 

Ma non fa uso di definizione dello schema per Stato, quindi la mia risposta si presenta in realtà come:

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

Come definire la proprietà dei dati per utilizzare la definizione dello schema? Oppure può essere fatto in un modo diverso?

Answer 1

Quanto può essere divertente il fatto che a volte le persone trovino la risposta subito dopo aver postato una domanda.

risposta è:

*   @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" 
*     ), 
*    ) 
*   ),