WS api differences

This article describes the differences between the SAFE X3 Web API and the SData 2.0 protocol specification.

URL Syntax

The SAFE X3 Web API differs from the SData 2.0 URL Syntax as follows:

• SAFE X3 URLs start with /api1/ instead of /sdata/.
• SAFE X3 URLs have a mandatory representation parameter, which is not present in SData.

Using the /api1/ URLS handles the stateless mode managed in web services:

• Every call must contain the authorization header
• The session cookie is not used
• The sessions managing the service are created on a dedicated connexion pool with a short time-out so they can be freed quickly if they are no more used