🚀 Master the language of AI with our brand new course: "Prompt Engineering for Everyone" Learn more

Offered By: IBM

Documenting RESTful APIs using MicroProfile OpenAPI

Explore how to document and filter RESTful APIs from code or static files by using MicroProfile OpenAPI.

Continue reading

Guided Project

Open Liberty

123 Enrolled
0.0
(0 Reviews)

At a Glance

Explore how to document and filter RESTful APIs from code or static files by using MicroProfile OpenAPI.

You will learn how to document and filter RESTful APIs from annotations, POJOs, and static OpenAPI files by using MicroProfile OpenAPI.

The OpenAPI specification, previously known as the Swagger specification, defines a standard interface for documenting and exposing RESTful APIs. This specification allows both humans and computers to understand or process the functionalities of services without requiring direct access to underlying source code or documentation. The MicroProfile OpenAPI specification provides a set of Java interfaces and programming models that allow Java developers to natively produce OpenAPI v3 documents from their JAX-RS applications.

You will document the RESTful APIs of the provided inventory service, which serves two endpoints, inventory/systems and inventory/properties. These two endpoints function the same way as in the other MicroProfile guides.
Before you proceed, note that the 1.0 version of the MicroProfile OpenAPI specification does not define how the /openapi endpoint may be partitioned in the event of multiple JAX-RS applications running on the same server. In other words, you must stick to one JAX-RS application per server instance as the behaviour for handling multiple applications is currently undefined.

Created by 

The Open Liberty Project team

Estimated Effort

1 Hour

Level

Intermediate

Language

English

Course Code

GPXX0YBFEN

Released

August 23, 2021

Last Updated

September 07, 2021

Tell Your Friends!

Saved this page to your clipboard!

Sign up to our newsletter

Stay connected with the latest industry news and knowledge!