Forbid use of reserved parameter name

Author: rafaelsales

lib/rspec_api_documentation/dsl/endpoint/set_param.rb

@@ -2,10 +2,17 @@ module RspecApiDocumentation
   module DSL
     module Endpoint
       class SetParam
+        RESERVED_WORDS = %w(status)
+
         def initialize(parent, hash, param)
           @parent = parent
           @hash = hash
           @param = param
+
+          if reserved_word?(key) && !custom_method_name
+            raise ArgumentError, "Parameter name '#{key}' is reserved. " \
+              "Please provide `method` argument with custom method name."
+          end
         end
 
         def call
@@ -46,12 +53,16 @@ def path_params
 
         def method_name
           @method_name ||= begin
-            [custom_method_name, scoped_key, key].find do |name|
-              name && example_group.respond_to?(name)
+            [custom_method_name, scoped_key, key].compact.find do |name|
+              example_group.respond_to?(name) && !reserved_word?(name)
             end
           end
         end
 
+        def reserved_word?(word)
+          RESERVED_WORDS.include?(word.to_s)
+        end
+
         def build_param_hash(keys)
           value = keys[1] ? build_param_hash(keys[1..-1]) : example_group.send(method_name)
           { keys[0].to_s => value }