Pro RESTful APIs with Micronaut: Build Java-Based Microservices with REST, JSON, and XML

© The Author(s), under exclusive license to APress Media, LLC, part of Springer Nature 2025

S. PatniPro RESTful APIs with Micronauthttps://doi.org/10.1007/979-8-8688-1243-9_4

4. API Design and Modeling

Sanjay Patni¹  

(1)

Milpitas, CA, USA

 

This chapter starts with API design strategies and then goes into API creation process and modeling. Best practices for REST API design are discussed, followed by API solution architecture. In the exercises, a simple API is designed for podcast subscription and then modeling using OpenAPI.

API Design Strategies

As the UI is to UX (user experience), the API is to APX (Application Programming Experience). In APX, it is important to answer the following questions:

• What should be exposed?

• What is the best way to expose ...