OpenAPI Domains

(v22.1.6 or later)

OpenAPI domains allow you to organize your endpoint and entity APIs for better usability. You can assign endpoints and entities to the same domain to group them together and you can define parent - child relationships between domains to create API hierarchies that are easy to understand and navigate.

IMPORTANT!  
A single level of children domains is supported. A child domain cannot be a parent for other domains.

In the Swagger interface (<environment URL>/ftosapi/swagger by default), two API definitions are created automatically for each root domain: one for the domain's endpoints and one for the domain's entities, while subdomains are prepended at the beginning of the API names.

Generic definitions include digital journeys, mass operations, and endpoints/entities that are not assigned to a domain.

Create an OpenAPI Domain

  1. In FintechOS Studio, go to Main Menu > Ecosystem > OpenAPI Domains.
  2. Click Insert.
  3. Fill in the domain's details:
    • Name - Unique identifier for the domain in the FintechOS.
    • Domain Name - Domain name as displayed in the user interface.
    • Description - Short description for the domain.
    • Parent Domain - Select a parent domain if you wish to make this a subdomain of an existing domain.
  4. Click Save and close.

Assign an Entity to an OpenAPI Domain

  1. In FintechOS Studio, go to Main Menu > Ecosystem > OpenAPI Domains.
  2. In the Open API Domains list, double click the desired domain.
  3. In the domain editor, scroll down to the Open API Domain Entities section.
  4. Click Insert.
  5. In the Add Open API Domain Entity page, use the Entity drop-down to select the desired entity.
  6. Click Save and close.
  7. Click Save and close.

Assign an Endpoint to an OpenAPI Domain

  1. In FintechOS Studio, go to Main Menu > Ecosystem > OpenAPI Domains.
  2. In the Open API Domains list, double click the desired domain.
  3. In the domain editor, scroll down to the Open API Domain Endpoints section.
  4. Click Insert.
  5. In the Add Open API Domain Endpoint page
    • Use the Endpoint drop-down to select the desired endpoint.
    • Use the Http Verb field to indicate the HTTP request method used to call the endpoint, such as GET, PUT, POST, etc.
  6. Click Save and close.
  7. Click Save and close.