Add versioning requirement to Provider API #216
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
provider
APIs must support versioning going forward. As implementedhere, we will use a custom media-type to negotiate the API version a client
and server will use. A couple reasons for taking this approach:
published with breaking changes that Providers, cities and third-parties
will need to implement/adopt on differing timelines.
their APIs against, mandating URI structure beyond endpoints could be
burdensome or limiting. Conversely, leveraging standard HTTP Headers in
a compliant manner places no limitations.
their own versioning in their registered
mds_api_url
.Closes #114