Swagger UI doesn't seem to support Arrays yet?

[johnhamelink]

Hey there,

Please excuse my relative ignorance, I'm using Swagger within the context of a rails app and I'm not particularly up to date with where swagger's UI is in comparison with swagger's spec. I wanted to ask, has the UI implemented the Array type? I want to be able to define an API with parameters that would resolve to this in the API:

foo[]=1&foo[]=2&foo[]=3

In grape-swagger-rails I'm able to define a parameter as such:

requires :foo, type: Array[Integer], desc: 'An Array of Foos'

grape-swagger-rails (I think it's that gem which does this) renders the following JSON spec:

And Swagger UI renders the output like this:

When it queries the API, it generates the following url:

http://localhost/example?foo=1

Which of course works, but isn't helpful for allowing people to test.

[webron]

That's not the right definition for an array. You need to end up with something that looks like:

"type": "array",
"items": {
  "type": "integer"
}

[johnhamelink]

@webron thanks I'll try to get grape-swagger-rails to do that.

[fehguy]

Take a look here @johnhamelink :

https://github.com/swagger-api/rails-petstore

[exoszajzbuk]

I've done the following things:

1. Cloned the swagger-ui repo
2. Checked out develop_2.0
3. Opened dist/index.html

It is using http://petstore.swagger.io/v2/swagger.json by default, which has collectionFormat: "multi" set on pet/findByStatus.

If I understand it right, it should send the query parameters as tags=tag1&tags=tag2, if I enter a comma-separated string for the value. Instead it sends the parameters by simply encoding the comma.

[webron]

@exoszajzbuk - that's not really related to the OP. Can you open a separate issue for that?

[exoszajzbuk]

@webron opened as #987

[webron]

@exoszajzbuk - thank you!

[marcinskubala]

Hi, collectionFormat: "multi" should work with in="formData" too! Currently it works ony with in="query".

[fehguy]

Hi @marcinskubala I believe formData (x-www-form-urlencoded) has a standard for how multiple values are passed so a configuration shouldn't be necessary.

[marcinskubala]

Hi @fehguy, thanks for your answer, but I know the standards. For example:

{
    "name": "devices",
    "in": "formData",
    "type": "array",
    "items": {
        "type": "integer"
    },
    "collectionFormat": "multi"
}

I should be able in UI to put in devices fileld values: "1&2&3" or "1,2,3" and the post parameters should look like:
devices: 1
devices: 2
devices: 3
but currently it looks like "devices: 1,2,3"

[fehguy]

OK what you describe is a different issue. The question is "how do you enter multiple values in an array" and isn't related to formData. I think the right solution is to use a text edit box and newlines as delimiters rather than ampersands or other

[marcinskubala]

yep, the easiest way is to use a text edit box as you said or some cloning functionality but it will be more problematic so the edit box would be fine for me.