What is Rest API?
A RESTful API is an application program interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data.
...
A RESTful API breaks down a transaction to create a series of small modules. Each module addresses a particular underlying part of the transaction. This modularity provides developers with a lot of flexibility.
How to set up Burti Rest API?
It is necessary to create script in server folder run-burti-web-api-requests.sh that will contain requests to the server, using the curl command-line tool:
...
h5. Parameters explained
As you can see, all the parameters are prefixed with a {{"0_"}} - this is a number for the request, and is used to make multiple data requests within a single API call. In this example, there is only one data request.
# {{query}} - the specific data interface (will be a separate interface for each register). In this case it's "Web_JSON_INVc_List.hal" for Items (register code {{INVc}}) - the naming of this interface will be the same accross all registers.
# {{full}} # full - whether to request the full data or a shorter list of fields - these fields are configured separately
# {{index}} - the index in Hansaworld's datadef, by which to lookup the data, advanced topic, simply use "Code" (might be something other for other registers)
# {{Code}} - the field name within the index, simply use "Code" (might be something other for other registers)
# {{fieldcnt}} - number of fields within the index, use 1 (might be something other for other registers)
# {{company}} - the company number from which we are requesting the data
# {{fieldlist}} - list of the fields within the index, comma separated, use "Code" (might be something other for other registers)
...
h4. Request full list of items
{{sample.get.data2.txt}} - made to the READ interface {{Web_JSON_Composer.hal}}:{
| Code Block |
|---|
...
0_query=Web_JSON_INVc_List.hal&0_count=500&0_full=false&0_sort_only=true&0_index=Code&0_company=1&1_query=Web_JSON_INVc_List.hal&1_count=500&1_full=false&1_sort_only=true&1_index=Code&1_company=2 |
...
h5. Parameters explained
In this example you can see that there are two groups of parameters - prefixed with "0_" and "1_". This illustrates two separate data requests within a single call. The response data will be similarly grouped.
...