Versions Compared

Old Version 4

changes.mady.by.user Morten Østerlund Jørgensen

Saved on

compared with

New Version 5

changes.mady.by.user Morten Østerlund Jørgensen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Himsa HIMSA strives to provide developers with stable APIs to integrate against while still being able to provide new and expanded functionality.

To balance these two goals we provide different API versions and only add new features to the latest version of the API. This allows you to choose the best time to update your integration and take advantage of new features.

Requesting a version

TODO

Jira Legacy
serverSystem JIRA
serverId1ca96d0c-73f7-3174-978f-e82aa549931b
keyNE-551
: Part of URI or a header?Specify version in the X-API-Version header.

API Deprecation

To signal that an API version is deprecated and will be removed in the future, the API responds with the following headers:

  • Noah-Deprecated: TRUEBoolean
  • Noah-Sunset-Date: 2018-06-01T00:00:00

...

  • ISO 8601 date time (UTC) when the version will no longer be accessible.

Your integration should check for those headers so you can make updates in a timely fashion.