Defining path parameters

Path parameters are defined in the "Path parameters" dialog step.

At least one path parameter

An API URL must contain at least one path parameter.

Static, meaningful path parameters are useful as the (first) path parameters.

Click the icon to define a new path parameter.

Path parameter types

Generally speaking, the following path parameters (types) can be defined:

Static path parameters

Example

/api/app/1A2B3C4D5E/v1

For static path parameters, there is no assignment to a data field.

For example, you can use a static path parameter to version the Application API by assigning "v1" or a similar name.

  1. Click "Static".

  2. Enter a name in the "Name" field.

    The name must be at least two characters long and begin with a lowercase letter. In addition, it must contain only alphanumeric characters and underscores.

Variable path parameters

Example

/api/app/1A2B3C4D5E/{store-id}

  1. Variable path parameters with "immediate" data field mapping

    For all actions except "Read multiple data records", a selection dialog is available in the "Path parameter" dialog with which you can assign the path parameter to a data field.

    Click on "Data field" and then select the desired data field.

  2. Variable path parameters with data field mapping via the filter dialog

    For the action "Read multiple data records", you initially only need to assign a name for the parameter and select a data type in the "Path parameters" dialog step.

    Assigning the path parameter to a data field is done in the "Filters and sorting" dialog step.

    Detailed information is available in the following sections:

General information about path parameters