api-blueprint
api-blueprint copied to clipboard
How to deal with versioned APIs using URL prefix?
We're versioning using a URL prefix, for example, /v1/me
and /v2/me
.
We can of course create two separate api blueprints but this is not ideal and would probably be problematic for us---the reason is because subsequent API versions will share a significant portion of the API, meaning this strategy increases the chance that docs go out of sync.
Ideally, it would be nice if there was a way to share endpoints between Groups---this is similar to how we'll actually code the backend.
@frankandrobot May this issue help you: https://stackoverflow.com/questions/32419425/does-apiary-io-and-or-api-blueprint-support-api-versioning