added support for nicknamed routes

lib/grape-swagger/endpoint.rb

@@ -110,7 +110,7 @@ def method_object(route, options, path)
       method[:parameters]  = params_object(route)
       method[:responses]   = response_object(route, options[:markdown])
       method[:tags]        = tag_object(route)
-      method[:operationId] = GrapeSwagger::DocMethods::OperationId.build(route, path)
+      method[:operationId] = operation_id(route, path)
       method.delete_if { |_, value| value.blank? }
 
       [route.request_method.downcase.to_sym, method]
@@ -133,6 +133,12 @@ def description_object(route, markdown)
 
       description
     end
+
+    def operation_id(route, path)
+      operation_id = route.options[:nickname] || GrapeSwagger::DocMethods::OperationId.build(route, path)
+
+      operation_id
+    end
 
     def produces_object(route, format)
       mime_types = GrapeSwagger::DocMethods::ProducesConsumes.call(format)

spec/swagger_v2/nicknamed_api_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe 'a nicknamed mounted api' do
+  before :all do
+    class NicknamedMountedApi < Grape::API
+      desc 'Show this endpoint', nickname: 'simple'
+      get '/simple' do
+        { foo: 'bar' }
+      end
+    end
+
+    class NicknamedApi < Grape::API
+      mount NicknamedMountedApi
+      add_swagger_documentation
+    end
+  end
+
+  def app
+    NicknamedApi
+  end
+
+  subject do
+    get '/swagger_doc.json'
+    JSON.parse(last_response.body)
+  end
+
+  it "uses the nickname as the operationId" do
+    expect(subject['paths']['/simple']['get']['operationId']).to eql('simple')
+  end
+end