Grape Swaggerでドキュメントが表示されない問題

https://github.com/tim-vandecasteele/grape-swagger
swagger_docがNot Foundだったり一部APIが表示されなかったりいくつかハマったのでメモ。

バージョン指定してる時

add_swagger_documentation api_version: "v1"

ベースURLを変更してる時

add_swagger_documentation base_path:"/api"

パラメータ付きのAPIしか表示されない時

• grapeのコードのresource "***" 以下にもformatを指定する。
• もっと良い方法があるのかも。

  class API < Grape::API
    format :json
    ...
    ...
    resource "aaa" do
      format :json
    ...
    ...
    resource "bbb" do
      format :json
    ...
    ...