Integration API Routes

Itential Platform automatically creates integration API routes for all paths listed in an integration model. This allows you to use Itential Platform as a gateway for the routes defined in the OpenAPI (OAPI) document.

Route Example

When Itential Platform creates a route for an integration it does so by using the name of the integration service and the operationId used in the OAPI document. Let's use a GitHub OAPI document as an example. Take the following path object in the OAPI document (response definitions removed for brevity).

    "/emojis": {
      "get": {
        "summary": "Emojis_GET",
        "description": "Lists all the emojis available to use on GitHub.",
        "operationId": "Emojis_GET",
        "parameters": [
          {
            "name": "Accept",
            "in": "header",
            "description": "Is used to set specified media type.",
            "style": "simple",
            "schema": {
              "type": "string"
            }
          }
        ],
        "deprecated": false
      }
    }

Itential Platform will create a route based on the integration name and the operationId used in the OAPI document. So, if we name our integration MyGitHub then IAP would create the following route for /emojis:

http://<IAP base path>/MyGitHub/Emojis_GET

Reference

You can see the routes created by Itential Platform on the Help Desk page under Adapter/Integration API.

Navigate to the menu icon on the left. Select Help and then click the View Documentation button under Adapter/Integration API.

http://<IAP base path>/help

You can see detailed information about the OAPI document under the Integration Models section of Admin Essentials.

Click on the name of the integration model and Itential Platform will render all the information contained in the OAPI document in the right panel.

Other Uses

Exposed adapter routes can also be used in JSON Forms validation in the same manner as application routes. Just find your base URL and API route in the dropdowns.