Varga E. Creating Maintainable APIs: A Practical, Case-Study Approach

Apress, 2016. — 295 p. — ISBN: 978-1-4842-2195-2
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 JSONWho This Book Is For:This book is for any level software engineers and very experienced programmersInformation Hiding and APIs
Modular Design
Designing Classes for Reuse
TDD as an API Design Technique
Identifying Resources
Versioning REST APIs
Encoding Actions on Resources
Implementing Synchronous and Asynchronous REST APIs
Documenting REST APIs
Testing REST APIs
Implementing Messaging APIs
Apache Kafka as a Messaging Hub
Testing Messaging APIs
Schema-Based Messages
The Core JSON API
Evolving the JSON API
Katharsis