API Management – English

API Gateway

Speed up your API development and bring your integration landscape to the next level

eMagiz delivers a powerful API Management solution and offers all features a modern API Gateway should possess. An API Gateway is one of the integration patterns that eMagiz offers to solve business challenges. This integration pattern is mostly used to handle synchronous requests, whereby responses are usually used in business applications to advance business processes. 

What is an API Gateway?

An API Gateway publishes available APIs to connected applications, so that they may call specific operations to retrieve or process data. The gateway offers data in a synchronous manner – on the basis of the API response, the calling application will determine the next step in the process. A large advantage is that developers of calling application, for example a microservice, can uniformly handle message exchange on the basis of standard protocols and formats. 

Why an API Gateway?

API Gateways are often used in a microservice landscape, in which the access to organization-wide functionality is made available as API. All data is offered uniformly to consuming applications or is processed by the API in a standard way with clear parameters. One of the added advantages is that access to data is standardized and made available with corresponding semantics to achieve uniformity. Developers of consuming applications can research the API on their own using the standard description that is made available. eMagiz supports OpenAPI 3.0 and visualizes APIs using SwaggerUI.

For a typical use case, the API is published to external parties, for example customers or suppliers. Customers can discover the APIs themselves and request the data they need for their business process. Similarly, they can directly post data into the back-office of the organization. This ensures that the API owner does not have to do any manual labor in order to onboard new parties. This can all be done from the self-service portal, in which documentation and mock-up services are available.

Technology

The eMagiz API Gateway publishes a schema of data and operations that have been made available, along with corresponding parameters that are required. A portal is made available for authenticated users, where they can send messages to a REST webservice, which will return JSON formatted messages.  

Messages are handled through the published URL in a synchronous manner with guaranteed response and delivery. On the backend operations, transformations can be realized to change content of protocols so that a higher degree of flexibility can be attained. This results in the ability to connect modern APIs to legacy on-premises systems or other data sources. The API gateway offers a transparant connection for end-users and hides the complexity of back-end operations. 

eMagiz offers users varying options to secure their APIs, inclusing API keys. API callers are managed in the API Gateway, so that they can receive the required authorization on both the data and backend operation level. 

Advantages of the API Gateway by eMagiz

Faster time to-market
    • Self-service for development teams and consuming applications
    • No point-to-point connections for organizations
Increase reusability of endpoints and data
    • Use existing interfaces
    • Standardize protocols and definitions for both the internal and external organization
Improved controllability
    • Standardized access & security management
    • Centralized monitoring & logging