Developer documentation

Flexible data retrieval

In the construction of the Reeleezee API, we followed the OData v4 specifications. Open Data Protocol (OData) is a RESTful data access protocol initially defined by Microsoft. The protocol enables the creation and consumption of REST API’s which allow resources, identified using URL’s and defined in a data model, to be published and edited by Web clients using simple HTTP messages. It is not limited to relational databases.[/vc_column_text][vc_column_text]Following are the supported system query options in Reeleezee API to get started:

Expand System Query Option – $expand
When a request URI is specified with $expand System query option, it expands the single property mentioned along with the option.

Example:
Request to expand the Address property:

/api/v1/customers?$expand=Language

Similarly, a request URI specified with $expand=* System query option, expands all the properties.

Example:
Request to expand all properties with:

/api/v1/salesinvoices?$expand=*

Furthermore, there are a lot of other ways you can use depending on your requirements. Below are certain ways are specified for you to explore and experiment with:

$expand=*($levels=2) – Expand all properties for 2 levels

$expand=*($levels=max) – Expand all properties for all levels

$expand=*/$ref – Expand all properties, but only return the id’s

$expand=*/$ref($levels=max) – Expand all references

Select System Query Option ($select)
To select a specific set of properties, use the $select system query option along with mentioning the properties to be retrieved in the request URI.

Example:
Request a list of products only showing the properties Description and Purchaseprice:

/api/v1/products?$select=Description,PurchasePrice

Expand System Query Option $expand and $select together:
A request URI can be created with multiple system query options to fetch specific data with specific level/property expansion.

Example:
Combining expand and select:

/api/v1/customers$expand=Entity($select=id,AdditionalName;$expand=Language/$ref,AddressList($select=Type))
NL Select your country