doushi9856 2019-03-25 12:09
浏览 2640
已采纳

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 01: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.

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

报告相同问题?

悬赏问题

  • ¥100 二维码被拦截如何处理
  • ¥15 怎么解决LogIn.vue中多出来的div
  • ¥15 优博讯dt50巴枪怎么提取镜像
  • ¥30 在CodBlock上用c++语言运行
  • ¥15 求C6748 IIC EEPROM程序固化烧写算法
  • ¥50 关于#php#的问题,请各位专家解答!
  • ¥15 python 3.8.0版本,安装官方库ibm_db遇到问题,提示找不到ibm_db模块。如何解决?
  • ¥15 TMUXHS4412如何防止静电,
  • ¥30 Metashape软件中如何将建模后的图像中的植被与庄稼点云删除
  • ¥20 机械振动学课后习题求解答
手机看
程序员都在用的中文IT技术交流社区

程序员都在用的中文IT技术交流社区

专业的中文 IT 技术社区,与千万技术人共成长

专业的中文 IT 技术社区,与千万技术人共成长

关注【CSDN】视频号,行业资讯、技术分享精彩不断,直播好礼送不停!

关注【CSDN】视频号,行业资讯、技术分享精彩不断,直播好礼送不停!

客服 返回
顶部