Swagger JSON cannot parse Array of Hash in params

[RIstiaque]

When inputting the following code for a method:

  param :param_1, Array, of: Hash, desc: 'Array of Objects', required: true do
    param :param_2, String, required: true
    param :param_3, String, required: false
  end

It outputs the following after running this command: rails apipie:static_swagger_json:

However in the response, there is the array_of property which allows me to make an array_of: Hash:

  returns code: 200 do
    property :array_1, array_of: Hash, desc: 'Array of Objects', required: true do
      property :prop_1, String
      property :prop_2, String
    end
  end

Which results in the following:

Is there a reason that the array_of is only limited to responses?

After forking and cloning APIPie locally, I uncommented this line:

apipie-rails/lib/apipie/param_description.rb

Line 93 in 7cc859e

raise "an ':array_of =>' validator is allowed exclusively on response-only fields" unless @response_only

And was able to get the first piece of code working after refactoring to array_of: Hash.

[mathieujobin]

Interesting. Could a config option resolve the problem ?

[wrobbins]

Also experiencing this issue.

[mathieujobin]

And was able to get the first piece of code working after refactoring to array_of: Hash.

@RIstiaque Are you planning to open a pull request with the fix you found?

any reason to keep that raise given some setting options ? or we should just allow it as you are using it?

[jaynetics]

quickfix without forking to allow param :foo, array_of: Hash do ...:

# config/initializers/apipie.rb

Apipie::ParamDescription.prepend(Module.new do
  POINTLESS_ERROR = "an ':array_of =>' validator is allowed exclusively on response-only fields"

  def raise(arg1, ...)
    super unless arg1 == POINTLESS_ERROR
  end
end)