Question

gem＆＃39; swagger-docs＆＃39;

rake swagger：docs

rails服务器

我的控制器位于app / controller / API / user_controller.rb

中

    module Api
    class UserController < ApplicationController

    swagger_controller :users, "Users"
    swagger_api :create do
        summary "Creates a new User"
        param :form, :name, :string, :required, "Name"
        response :unauthorized
        response :not_acceptable
    end

    def create
            render json: {message: "success"},status: 401
    end

end

端

但是当我进入

http://localhost:3000/api-docs.json

它无法正常工作。它不能显示正确的布局。比它提供的json代码。

{
"apiVersion": "1.0",
"swaggerVersion": "1.2",
"basePath": "/",
"apis": [
 {
   "path": "api/user.{format}",
  "description": "Users"
 }
]
 }

Answer 1

返回JSON是swagger-docs的默认行为。如果您想查看此screenshot的布局，您还需要使用swagger-ui。请参阅此处的示例https://github.com/richhollis/swagger-docs-sample/tree/c33e1e788b8ef5a71c86610fffbb145b243a725b/public/api

希望这会有所帮助：）

Swagger不在Rails Api工作

1 个答案: