我正在使用Swagger记录PHP REST-API。所以我定义了我的数据模型。我目前的问题是,某些字段的所需状态因不同的请求类型而异。我的模型看起来像这样:
* @SWG\Definition(required={"firstName", "lastName"})
*
* @SWG\Property(property="id", type="integer", example="5")
* @property integer $id
*
* @SWG\Property(property="firstName", type="string", example="Test Name")
* @property string $firstName
*
* @SWG\Property(property="lastName", type="string", example="Test Name")
* @property string $lastName
*
* @SWG\Property(property="created", type="string", example="2016-11-15 08:05:15")
* @property string $created
想要的是:
我知道我可以根据需要使用required = true标记字段,但这标记了在使用模型的任何地方都需要它们。到目前为止,我唯一想到的是put请求中的必需id,因为它是它自己的参数。
* @SWG\Parameter(
* name="id",
* in="path",
* required=true,
* type="integer"
* )