Support for accept_version_header?

[giorgian]

I have:

class MyAPI < Grape::API
  version :v1, using: :accept_version_header, cascade: true
  ...

  add_swagger_documentation
end

When I go to http://localhost:3000/api/swagger, it wants to fetch its info from http://localhost:3000/api/v1/swagger_doc, which doesn't exist.

Is there a way to tell grape-swagger that I'm using accept_version_header?

[LeFnord]

Hi @giorgian … sorry, but version header isn't supported at the moment

[akrisanov]

What about the next way?

API_VENDOR  = "vendor"
API_VERSION = "v1"
API_VERSION_HEADER = "application/vnd.#{API_VENDOR}.#{API_VERSION}+json"

version API_VERSION, using: :header, vendor: API_VENDOR, strict: true

....
# Set produces for the particular request
desc "Get single product", produces: API_VERSION_HEADER
...

[LeFnord]

Hi @akrisanov … think to get the informations isn't the real problem, its more how to document it,
it could be done via a global parameter, but how should the vendor be handled?
should it also be added to the global consumes object? Would it be respected by the path specific ones? → here the spec isn't really consistent :(

[akrisanov]

@LeFnord got it, thanks for the clarifying it for me.

[LeFnord]

@akrisanov would be fine, if you can share your solution, thanks