Multiple separate apis per-application ?

Looks like some configs like OPENAPI_URL_PREFIX are fixed to the application and this prevents the ability to have multiple apis for 1 app. The simplest case I’d think 1 Api() per major-version. So you’d want a completely separate api between /v1/ and /v2/.

[sjhewitt]

I’m more than happy to rebase the PR if there’s a chance of getting it merged…

[sjhewitt]

I didn’t see this issue and ended up supporting multiple APIs just by passing kwargs down to the DocBlueprintMixin. See #259

This lets you set up the APIs like this:

api1 = Api(
    app,
    spec_kwargs={
        "title": "API 1",
        "version": "v1",
        "openapi_version": "3.0.2",
    },
    doc_kwargs={
        "name": "api-docs-1",
        "url_prefix": "/api1",
        "redoc_url": "https://cdn.jsdelivr.net/npm/redoc@2.0.0-rc.53/bundles/redoc.standalone.js",
        "redoc_path": "/docs",
    },
)

api2 = Api(
    app,
    spec_kwargs={
        "title": "API 2",
        "version": "v0.0.1",
        "openapi_version": "3.0.2",
    },
    doc_kwargs={
        "name": "api-docs-2",
        "url_prefix": "/api2",
        "swagger_ui_url": "https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.24.2/",
        "swagger_ui_path": "/docs",
    },
)

The minor drawback is that it doesn’t support configuration through the Flask app.config using namespacing as you have discussed, but given it’s an advanced feature it may be acceptable