API Integrator Open Metadata Integration Service (OMIS)
The API Integrator OMIS supports the exchange of data assets and their related schema and connection information between an external API manager and the open metadata ecosystem.
It supports a type of integration connector that are able to create DeployedAPI assets along with its associated API specification (APISchemaType). Optionally, this metadata can be tied to an APIManager.
Figure 1 shows the types of metadata that integrators connectors can create with this integration service.
Figure 1: API metadata supported by the API Integrator OMIS
The structure of an API specification consist of a number of APIOperations which in turn have optional APIParameterLists for the header, request and response. The details of these payloads are described using SchemaAttributes and SchemaTypes.
Figure 2 shows the open metadata types used to represent the metadata created through this service.
Figure 2: API open metadata types supported by the API Integrator OMIS
If an APIManager is defined, any API created is automatically linked to it using the ServerAssetUse relationship. When an APIOperation is created for the API, the service automatically inserts the AssetSchemaType relationship, APISchemaType entity and APIOperations relationship in between the DeployedAPI entity and the APIOperation entity.
Any schema attributes created through this interface will use the APIParameter subtype to allow for find requests that only return schema information for APIs. The schema attributes also use the TypeEmbeddedAttribute classification method for defining the schema type.
The modules are as follows:
api-integrator-api - defines the interface for an integration connector that is supported by the API Manager Integrator OMIS. This includes the implementation of the context that wraps the Data Manager OMAS’s clients.
api-integrator-server - implements the context manager for the API Integrator OMIS.
api-integrator-spring - implements a rest API for validating that a specific integration connector is able to run under this service.
api-integrator-client - implements a Java client for the REST API.
This integration service is paired with the Data Manager Open Metadata Access Service (OMAS).
- Return to the Integration Services
License: CC BY 4.0, Copyright Contributors to the ODPi Egeria project.