Add definitions and properties

Definitions let you define how an API response looks like. To simplify the work when you integrate data from an API into an application, create a definition for each possible response the API gives.

In this task, you learn how to add a definition to a server script API manually. With many APIs, you can import definitions or derive definitions from sample requests instead. Learn more.

Procedure

  1. In the Definitions tab, select + to add a definition.

  2. Enter a Name, for example, charactersPerPlanet, and Description.

  3. In the Properties tab, select + Add.

    Result: The API Designer adds a new line to specify a property.

  4. For each property, enter a Name that indicates what kind of information the property will hold, for example, planet, and characters.

  5. Select the allowed Type for the property.

    If you select Array or Object, go to the Actions column and select + to add sub-properties to the property.
  6. Enter a Description.

  7. If you want the property to be mandatory, select the Required checkbox.

  8. Select Save.

Results

  • You have added a definition and corresponding properties to a server script API.