OAS3 requestBody to include all defined parameters

Author: krasnoukhov

lib/rspec_api_documentation/writers/open_api_writer.rb

@@ -208,9 +208,14 @@ def extract_request_body(example)
           body = example.requests.map { |req| JSON.parse(req[:request_body]) rescue nil }.compact.reduce({}, :merge)
           return nil if body.empty?
 
+          schema = get_schema(body)
+          example.extended_parameters.select { |p| p[:in].nil? }.each do |parameter|
+            inject_body_parameter(schema, parameter)
+          end
+
           OpenApi::RequestBody.new(
             content: {
-              'application/json' => OpenApi::Media.new(schema: get_schema(body), example: body)
+              'application/json' => OpenApi::Media.new(schema: schema, example: body)
             }
           )
         end
@@ -255,6 +260,20 @@ def extract_known_parameters(parameters)
         parameters.select { |parameter| %w(query path header cookie).include?(parameter[:in].to_s) }
           .map { |parameter| extract_parameter(parameter) }
       end
+
+      def inject_body_parameter(schema, parameter)
+        scope = schema
+        parameter[:scope] && Array(parameter[:scope]).each do |curr|
+          scope.properties[curr.to_s] ||= OpenApi::Schema.new(type: 'object', properties: {})
+          scope = scope.properties[curr.to_s]
+        end
+
+        scope.required ||= []
+        scope.required << parameter[:name].to_s if parameter[:required]
+
+        scope.properties[parameter[:name].to_s] ||= get_schema(parameter[:value])
+        scope.properties[parameter[:name].to_s].description = parameter[:description] if parameter[:description]
+      end
     end
 
     class OpenApiExample