doushi9856 2019-03-25 20:09
浏览 2631
已采纳

Swagger注释和OpenAPI v3.0中“Produces”的注释是什么?

On OpenAPI v2.0 and Swagger PHP the annotation for Produces was:

 /**
 * @SWG\Get(
 *      path="/posts",
 *      operationId="getPosts",
 *      tags={"Authentication"},
 *      produces="application/json"
 *      summary="Returns the posts",
 *      description="Returns the posts",
 *      @SWG\Response(
 *          response=200,
 *          description="Successful operation"
 *      ),
 * )
 */

But On OpenAPI v3.0 and Swagger PHP I cannot find on how to annotate the produces on the documentation it states the it is now an attribute of the response @OA\Response but I can not find an example I already try just putting "content" = "application/json" but it doesn't work.

  • 写回答

1条回答 默认 最新

  • dougang2749 2019-03-26 09:22
    关注

    You define all the possible response content types for each @OA\Response.

    E.g.:

         * @OA\Response(
         *         response=200,
         *         description="successful operation",
         *         @OA\JsonContent(
         *             type="array",
         *             @OA\Items(ref="#/components/schemas/Pet")
         *         ),
         *         @OA\XmlContent(
         *             type="array",
         *             @OA\Items(ref="#/components/schemas/Pet")
         *         )
         *     ),
    

    If your endpoint only generates JSON content, only define the entry for @OA\JsonContent.

    See the full example here.

    本回答被题主选为最佳回答 , 对您是否有帮助呢?
    评论

报告相同问题?

悬赏问题

  • ¥15 求差集那个函数有问题,有无佬可以解决
  • ¥15 【提问】基于Invest的水源涵养
  • ¥20 微信网友居然可以通过vx号找到我绑的手机号
  • ¥15 寻一个支付宝扫码远程授权登录的软件助手app
  • ¥15 解riccati方程组
  • ¥15 display:none;样式在嵌套结构中的已设置了display样式的元素上不起作用?
  • ¥15 使用rabbitMQ 消息队列作为url源进行多线程爬取时,总有几个url没有处理的问题。
  • ¥15 Ubuntu在安装序列比对软件STAR时出现报错如何解决
  • ¥50 树莓派安卓APK系统签名
  • ¥65 汇编语言除法溢出问题