API Examples Overview and Conventions¶
The example sections illustrate the use of the API for a number of calls,
using the curl
command line tool. Each example shows the command
and the console output.
API calls are illustrated:
From server
http://localhost
Referencing a relation:
relation/LineRelation
.
User authorization is for two administrator users:
one user has additional permissions to import and bulk load.
The Authorization header and hierarchy parameter in the URL identify the two users.
Field Display Policies and Configuration Templates in URL parameters can differ according to the MenuLayout associated with the user role, for example,
&policy_name=LineMenuFDPSite
is a Field Display Policy applied torelation/LineRelation
from a Site administrator user menu.
Where a response to an API call shows an instance of
/api/tool/Transaction/
, the transaction instance details can be inspected with a GET call to this instance. An example is shown in this section.Some payload files and console output is truncated (indicated with ellipses or text: “snippets”).
Line breaks have been added to console output in the examples for better formatting.
The a selection of the MS Excel bulk load sheet
LineRelation.xlsx
columns are shown in a table.