Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

REST API Evolution

ServicePower, like most modern software development organizations, has adopted an agile methodology where we deliver incremental functionality over shorter time periods. As it is impossible to guess all future client needs and market directions, this agile approach allows us to more rapidly meet our clients needs in a more timely fashion. This rapid release cycle means that as our ServiceMobility product evolves so too will our REST APIs.

ServiceMobility REST APIs are updated in an additive manner which means that:

  • New APIs will be added; and
  • New fields are added to existing APIs.

Wherever possible, changes to existing APIs will ensure that new fields added will be optional, so as not to break existing customer integration efforts.

However, if a major breaking change is required to a REST API, then a new implementation with a new version number will be added to the system. The old version of the interface will remain, for a specified period of time, in order to maintain backward compatibility.

 

On this page:

ServiceMobility Release API Information

Throughout the API documentation, there are two locations where ServiceMobility release version numbers are listed:

 

  1. At the top of every REST API page is a single ServiceMobility release version number in green, for example: 3.0.0
    1. This number indicates the ServiceMobility release in which the API was introduced.
    2. So, for example, the 3.0.0 version number listed on the top of the REST Standard REST APIs Account Locations REST API page indicates that this API was introduced in version 3.0.0 of ServiceMobility.
    3. Users of ServiceMobility running a version prior to the indicated introduced version on an API will need to upgrade to at least the listed version to be able to use the API in any integration with ServiceMobility.
  2. At the top of some REST API pages are one or more ServiceMobility release version numbers in yellow, for example: 3.18.0
    1. These numbers indicates the ServiceMobility releases in which the API was changed.
    2. So, for example, the 3.18.0 version number listed on the top of the REST Standard REST APIs Inventory REST API page indicates that this API was changed in version 3.18.0 of ServiceMobility.
    3. Users of ServiceMobility upgrading to a new version where they integrate with APIs that have changed will need to review the changes to that API, to ensure that their integration remains compatible following on from an upgrade.
  3. In the description of some object properties there may be a single ServiceMobility release version number in grey, for example: 3.19.0
    1. This number indicates the ServiceMobility release in which the relevant property was added to the existing object.
    2. So, for example, the 3.19.0 version number listed in the description of the TaxExempt property of the REST Object Definitions Account Location Related Objects Account Object page indicates that the TaxExempt property was introduced in version 3.19.0 of ServiceMobility.
    3. Users of ServiceMobility running a version prior to the indicated introduced version on an object property will need to upgrade to at least the listed version to be able to use the object property in any integration with ServiceMobility.
  • No labels