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