Summary

This chapter acted as a foundation to help you understand the principles of REST API design. To do so, we focused on the HTTP protocol, which is the basis for virtually all REST API communication. We then covered the REST API design constraints, setting the stage for what it means to create a RESTful API. With this groundwork, we walked through RMM and WADMM to assess whether our designs meet REST design constraints and to what degree. Finally, we proposed an approach for updating your API so that it meets the required maturity level and is more reliable and consumer-friendly. In the next chapter, we’ll discuss constructing an API design domain model and how it shapes the foundation of effective API design. We’ll explore the role of API modeling, take a closer look at JSON Schema as a modeling tool, and highlight the importance of adopting the minimal API surface principle. Finally, we’ll bring these ideas together by constructing an API design domain...