Responses

Every operation needs at least one response, but usually a success and an error response.

Create a response

A response can be created in the Responses tab of a Domain Namespace's Overview page by using the Create capability.

Responses are defined using the following master data:

  • Identifier: This is the identifier (name) of the response. It is unique within a namespace. Please note that only the characters A-z (without special characters), digits and the special character "_" are permitted for naming response! Furthermore, names may not begin with a digit and the first character must be uppercase. The identifier cannot be changed after creation.

  • Required: This is a Boolean. If it is checked then the response is required, otherwise it is optional

  • Content Type: It is a selection element with only one choice: application/json. This field is mandatory only if a schema type has been selected

  • Schema: This is a list of all the schema types that have already been created. The one chosen will be the schema type of the response that s being created. responses can only be of type Array/Object/OneOf (required)

  • Description: This is used to give a longer description of the response (optional)

Edit a response

You can edit a response by using the Information capability, navigating to the Master Data section and using the Edit Master Data capability or by using the inline Edit capability. The fields that can be edited are the Content Type, the Schema and the Description.

Delete a response

You can delete the response by using the inline Delete capability. Alternatively, you can use the Information capability to access the Details view and there you can use the Delete capability.

You will need to confirm the action before the selected response is permanently deleted.

Note: You can only delete a response if it is not in use.