Part 3 Extending APIs

 

Part 3 continues developing the PetSitter API, but now diving into more advanced OpenAPI topics. We’ll look at what goes into making an internal API public.

We’ll continue the process of domain modeling and mapping it over to OpenAPI, where we’ll introduce a new change to the API (chapter 15). Then we’ll encounter more advanced JSON Schema, such as composition with oneOf, anyOf (chapter 16), and properties for input validation (chapter 19). We’ll look at pagination, filtering, and sorting parameters (chapter 17). And later we’ll dive deeper into error handling (chapter 18) as we continue to extend our OpenAPI vocabulary.

Any API worth its salt needs to consider versioning and breaking changes (chapter 20). We’ll finish off this part with an API release checklist and introduce a few topics not covered in this book but that are worth noting (chapter 21).