Versioning

Multiple ways to achieve versioning:

  • In URI:
    • Example: /my-api/v2/resource
  • In Accept Header as custom media type:
    • Example:Accept: application/vnd.case-file.v2 + json
  • In URI as parameter:
    • Example: /my-api/resources?version=2
  • As custom header:
    • Example:X-APIVersion: 2

In ArkCase we are using URI versioning.