api-blueprint icon indicating copy to clipboard operation
api-blueprint copied to clipboard

How to deal with versioned APIs using URL prefix?

Open frankandrobot opened this issue 6 years ago • 1 comments

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 avatar Mar 06 '18 05:03 frankandrobot

@frankandrobot May this issue help you: https://stackoverflow.com/questions/32419425/does-apiary-io-and-or-api-blueprint-support-api-versioning

anhldbk avatar Jul 12 '18 02:07 anhldbk