Creating Maintainable APIs: A Practical, Case-Study Approach

Build straightforward and maintainable APIs to create services that are usable and maintainable. Although this book focuses on distributed services, it also emphasizes how the core principles apply even to pure OOD and OOP constructs.

The overall context of Creating Maintainable APIs is to classify the topics into four main areas: classes and interfaces, HTTP REST APIs, messaging APIs, and message payloads (XML, JSON and JSON API as well as Apache Avro).

What You Will Learn:

• Use object-oriented design constructs and their APIs
• Create and manage HTTP REST APIs
• Create and manage maintainable messaging APIs, including the use of Apache Kafka as a principal messaging hub
• Handle message payloads via JSON

Who This Book Is For:

This book is for any level software engineers and very experienced programmers.

Table of Contents

Chapter 1: Information Hiding and APIs
Chapter 2: Modular Design
Chapter 3: Designing Classes for Reuse
Chapter 4: TDD as an API Design Technique
Chapter 5: Identifying Resources
Chapter 6: Versioning REST APIs
Chapter 7: Encoding Actions on Resources
Chapter 8: Implementing Synchronous and Asynchronous REST APIs
Chapter 9: Documenting REST APIs
Chapter 10: Testing REST APIs
Chapter 11: Implementing Messaging APIs
Chapter 12: Apache Kafka as a Messaging Hub
Chapter 13: Testing Messaging APIs
Chapter 14: Schema-Based Messages
Chapter 15: The Core JSON API
Chapter 16: Evolving the JSON API
Chapter 17: Katharsis