API Request Headers

Note

VOSS Automate will not support API Backward Compatibility from release 21.1 and future releases. From release 21.1 forward, the following must be removed from API requests.

• API parameter: api_version=<version_number>

• Request header: X-Version:<version_number>

API Headers are available for pagination of choices and macro results in an API call.

The headers are X-range and Range, with the starting value as 0. These override and can be used instead of the skip and limit API parameters.

For example, the following examples return the same results:

GET /api/tool/Macro/?method=evaluate
     &hierarchy=[hierarchy]
     &input={{fn.lines}}
     &skip=0
     &limit=6



GET /api/tool/Macro/?method=evaluate
     &hierarchy=[hierarchy]
     &input={{fn.lines}}

     Request headers:

     X-Range: items=0-5
     Range: items=0-5

If the request is items=0-199 (for 200 items) and there are more results, the response will show:

Content-Range:items 0-199/999999999

Since it is undetermined how many items there are, the value 999999999 represents the total.

In this example, we have a total of 298 items. if a subsequent request is for the next 200 items (200-399), this includes the total. The response will then also show the total number of items (298) returned by the macro:

Content-Range:items 200-399/298