12 API visualization

This chapter covers

  • Generating OpenAPI (previously known as Swagger UI) specifications for a project
  • Accessing OpenAPI project specifications
  • Visually inspecting project endpoints with the Swagger UI
  • Utilizing the design-first approach to developing APIs—the process of creating an API design before implementing it with code

Originally developed in 2010 as a way for defining machine-readable interfaces to describe RESTful services, in 2016, the Swagger specification was rebranded as the OpenAPI specification under a new OpenAPI initiative sponsored by the Linux Foundation. Other benefits to an OpenAPI specification of a service follow:

  • Creating interactive documentation of a service

  • Automation of test cases based on ...

Get Kubernetes Native Microservices with Quarkus and MicroProfile now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.