Я документирую PHP REST-API с помощью Swagger. Итак, я определил свою модель данных. Моя текущая проблема заключается в том, что требуемое состояние некоторых полей зависит от типа запроса. Моя модель выглядит так:
* @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, так как он сам по себе является параметром.
* @SWG\Parameter(
* name="id",
* in="path",
* required=true,
* type="integer"* )
Задача ещё не решена.
Других решений пока нет …