Swagger.php: как изменить заголовок запроса POST Content-type

Question

Я использую lib: darkaonline / l5-swagger (^ 5.5) (который содержит swagger-php + swagger-ui), мне нужно изменить Content-Type заголовка в моем POST-запросе, чтобы загрузить файл (чтобы прочитать его в Laravel Input::file('Фото')). Я прочитал, что я должен добавить consumes а также produces Параметры моего чванства - вот что у меня есть:

/**
 *
 * Create Building Photo
 *
 * @SWG\Post(
 *     path="/api/v1/buildings/{buildingId}/photo",
 *     security={{"oauth2": {"*"}}},
 *     tags={"building"},
 *     consumes={"text/plain", "application/json"},
 *     produces={"text/plain", "application/json"},
 *     description="Update building",
 *     @SWG\Parameter(
 *         name="buildingId",
 *         in="path",
 *         description="Building id",
 *         required=true,
 *         type="number",
 *     ),
 *     @SWG\Parameter(
 *          name="photo",
 *          in="formData",
 *          required=true,
 *          description="Building photo",
 *          type="file",
 *     ),
 *     @SWG\Response( response=200, description="ok"),
 *     @SWG\Response( response=404, description="Building not found"),
 * )
 *
 */

Но в запросе Content-type а также Accept Я всегда получаю application/json и laravel не может прочитать загруженный файл (когда я генерирую запрос, используя swagger-ui). Как я должен изменить выше Swagger, чтобы разрешить чтение laravel Input::file('photo') из POST-запроса, сгенерированного swagger-ui?

Answer 1

Это решение:

 *     consumes={"multipart/form-data"},
 *     produces={"text/plain, application/json"},

:)

Answer 2

Пожалуйста, найдите решение здесь.

Вы должны следовать этим рекомендациям, чтобы настроить Swagger в Laravel с паспортной аутентификацией и многое другое.

https://github.com/DarkaOnLine/L5-Swagger

Здесь перечислены некоторые проблемы, с которыми вы можете столкнуться во время реализации.

https://github.com/DarkaOnLine/L5-Swagger/issues/57