Skip to content
/ api-layer Public

The API Mediation Layer provides a single point of access for mainframe service REST APIs.

License

Notifications You must be signed in to change notification settings

zowe/api-layer

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

6e2436e · Dec 20, 2022
Aug 18, 2020
Dec 20, 2022
Oct 30, 2018
Dec 16, 2022
Nov 25, 2022
Dec 7, 2022
Dec 16, 2022
Sep 9, 2022
Nov 25, 2022
Oct 7, 2022
Sep 9, 2022
Sep 14, 2022
Dec 8, 2022
Nov 25, 2022
Jul 27, 2022
Nov 25, 2022
Nov 25, 2022
Jul 27, 2022
Nov 25, 2022
Dec 7, 2022
Jul 8, 2019
Dec 7, 2022
Oct 19, 2022
Sep 8, 2022
Jun 18, 2019
Dec 7, 2022
Nov 25, 2022
Nov 25, 2022
Dec 5, 2022
Mar 2, 2022
Nov 25, 2022
Dec 13, 2022
Dec 7, 2022
Nov 22, 2022
Dec 16, 2022
Nov 25, 2022
Dec 13, 2022
Nov 25, 2022
Nov 25, 2022
Jul 27, 2022
Sep 9, 2022
Oct 12, 2022
Jul 27, 2022
Jul 27, 2022
Jul 12, 2022
Dec 16, 2022
Jul 27, 2022
Nov 25, 2022
Apr 6, 2020
Oct 7, 2022
Dec 20, 2022
Nov 25, 2022
Oct 5, 2022
May 12, 2020
Mar 29, 2021
Jul 12, 2022
Oct 30, 2018
Jul 12, 2022
Sep 14, 2022
May 26, 2021
Sep 9, 2019
Dec 12, 2022
Dec 6, 2022
Oct 30, 2018
Oct 25, 2022
Apr 19, 2021
Dec 5, 2022
Dec 16, 2022
Jul 26, 2022
Mar 12, 2021
Jan 25, 2022
Oct 30, 2018
Jul 26, 2022
Apr 8, 2022
Sep 14, 2022
Jan 4, 2021

Repository files navigation

API Mediation Layer

Build Status

Coverage Quality Gate Status

The API Mediation Layer (API ML) provides a single point of access for mainframe service REST APIs. The API ML offers enterprise, cloud-like features such as high-availability, scalability, dynamic API discovery, consistent security, a single sign-on experience, and documentation. The API ML consists of three components: the Gateway, the Discovery Service, and the API Catalog. The API ML facilitates secure communication across loosely coupled microservices through the API Gateway. The Discovery Service enables you to determine the location and status of service instances running inside the API ML ecosystem. The API Catalog provides a user-friendly, easy-to-use interface to view all discovered services, their associated APIs, and Swagger documentation.

Notes:

Contents

Run API Mediation Layer locally

Prerequisites

The following platform is required to run the API Mediation Layer:

The following tools are required to build and develop the API Mediation Layer:

  • Node.js version 10.23.3 and npm are required to be installed globally to run npm commands in project root folder.

Quick start

Follow these steps:

  1. Build all modules:
 ./gradlew build
  1. Install concurrently globally:
 npm install -g concurrently
  1. Run all service on your local machine:
 npm run api-layer

Alternatively, to use Docker to run the API ML, consult the Docker README.

Security

The API Mediation Layer can use dummy credentials for development purposes. For development purposes, log in using the default setting user for the username, and user as the password.

For more information, see API Mediation Layer Security.

Run integration tests

To run integration tests, follow the instructions in Integration Tests.

Certificates

For more information about how the certificates between API ML services are set up for localhost, see TLS Certificates for localhost.

Contributor guidelines

To add new functionality, follow the guidelines in Contributing.

Local configuration of services

To set local environment properties for testing on your local machine including HTTPS setup, follow the guidelines in Local Configuration.

Review IDE setup to see how to configure popular IDEs for API ML development.

Onboarding Services

For guidelines to onboard services, see Zowe Docs#Onboarding Overview.

More Information

To learn about: Refer to:
Core Service - API Catalog Zowe Docs
Core Service - API Catalog UI README
Core Service - Discovery Service Zowe Docs
Core Service - Gateway Service Zowe Docs
Core Service - Metrics Service README
Core Service - Metrics Service UI README
APIML SDK - Java Enabler Zowe Docs
APIML SDK - Micronaut Enabler Zowe Docs
APIML SDK - Node.js Enabler Zowe Docs
APIML SDK - Spring Enabler Zowe Docs
APIML SDK - ZAAS Client Zowe Docs
Sample Service - Java Enabler README
Sample Service - Spring Enabler README
Sample Service - Micronaut Enabler README
Sample Service - NodeJS Enabler README

Contact Us

Get in touch using Zowe Communication Channels. You can find us in the #zowe-api channel on Slack.