LabOne API Level¶
We recommended to use the highest level (API Level 6) in order to have access to the latest features available.
The HF2 Series only supports API Level 1.
All of the LabOne APIs are based on a common library. Needless to say, we try as hard as possible to make any improvements in our core API backwards compatible for the convenience of our users. We take care that existing programs do not need to be changed upon a new software release. Occasionally, however, we do have to make a breaking change in our API by removing some old functionality. This old functionality is, however, phased out over several software releases. First, the functionality is marked as deprecated and the user is informed via a deprecation warning (this can be turned off). This indicator warns that this function may be unsupported in the future. If we have to break some functionality, we use a so-called API level.
With support of new devices and features we need to break functionality, e.g. data returned by poll commands. In order to still support the old functionality we introduced API levels. If a program only uses old functionality the API level 1 (default) can be used. If a user needs new functionality, they need to use a higher API level. This will usually need some changes to the existing code.
The current available API levels are:
|API Level||Changes / Feature|
The Levels 2 and 3 are used only internally and are not available to the general public.