REST basics

Test Program

You can use the RESTClient to test run requests.

Have a look at the different objects on what methods they support.

Typically they support GET, PUT, sometimes POST and DELETE.

You can change the output format using the ACCEPT HTTP header.

Just add ot the the HTTP header:

Supported are:

You can also change the output format using an URL parameter added by colon : to the method part of the REST call.

Supported are:

Body is only used for PUT and POST.

The request body has to be encoded according to application/x-www-form-urlencoded and the charset has to be UTF-8. Don't forget about the urlencoding for strings.

Content-Type: application/x-www-form-urlencoded

Further details on how the request body should look like can be found in the explaination of the models.

The REST connection asks for an untermStrich username and password using Basic access authentication.

You have to create a special "REST user" for these actions.

The user has to have the right RESTSERVICES (48) set to MANAGEMENTPLUS (0).

Some requests can be called, using a standard untermStrich user:

Calls Either ADDRESSESANDCONTACTS or STAFFADMIN member right (For calls logging)
Addresses Either ADDRESSESANDCONTACTS or STAFFADMIN member right (For calls logging)
Staff Either ADDRESSESANDCONTACTS or STAFFADMIN member right (For calls logging)
- Only for the call all, returns only 'id', 'staff_name', 'direct_dial', 'staff_location_id'

If untermStrich has to reply with an error, it replies with a HTTP status codes Error (500) instead of OK (200).

The return body is the error message as a plain text.

Always use UTF-8.

untermStrich from X2 12.0 sends the header US-Version, which allows to dedect the untermStrich version running.