Root API Path and Versioning
The root path will be /api/orders which in turn hit the latest version of the API. All earlier versions will be available as /api/<version no>/orders.
APIs will have only one major revision number. All changes within a given version will remain backward compatible. Backward compatible changes include:
- Addition of new entities and custom actions.
- Support for additional verbs for resources that previously did not support them.
- Addition of new fields in responses.
- Mandatory request parameters may be made optional.