2016-03-18 12 views
4

SwaggerでGETリクエストのModel/Example valueセクションを生成することに懸念があります。 The linkの公式の例は、そのセクションを完全に示しています。それは既存のモデルを使用して生成された公式ドキュメントでSwaggerでGETリクエストのModel/Example valueセクションを生成する方法

:私の性質は、RESTによって生成されるため、

 *  @SWG\Schema(ref="#/definitions/User") 

私は、そのようなオプションを持っていません。

私は、次の方法を試してみました:それは作業と回答されていない

/** 
* @SWG\Get(
... 
*  @SWG\Response(
*   response="200", 
*   description="Ok", 
*   @SWG\Schema(
*    type="array", 
*    @SWG\Property(property="firstname", type="string", example="Steven") 
*  ), 
* ), 
*) 
*/ 

fetching resource list: http://localhost/dist/swagger.json; Please wait.

すべてのヘルプは高く評価されています。前もって感謝します。 GET /pet/findByStatusは例の一つで生成され

答えて

4


github.com/zircote/swagger-php/.../Examples/petstore.swagger.io/controllers/PetController.php

あなたがサポートされていないarrayタイプにプロパティを追加しているので、あなたのスニペットが機能していない理由があります。答えを

... 
*   @SWG\Schema(
*    type="array", 
*    @SWG\Items(
*     type="object", 
*     @SWG\Property(property="firstname", type="string", example="Steven") 
*   ) 
*  ), 
... 
+0

ありがとう:あなたは@SWG\Items注釈が必要になります配列の内容を記述するために

。ただし、配列をオブジェクトに変更するだけで済みました。 – Bandydan

関連する問題