API Design Patterns
- 9h 6m
- JJ Geewax
- Manning Publications
- 2021
API Design Patterns lays out a set of design principles for building internal and public-facing APIs.
Summary
A collection of best practices and design standards for web and internal APIs.
In API Design Patterns you will learn:
- Guiding principles for API patterns
- Fundamentals of resource layout and naming
- Handling data types for any programming language
- Standard methods that ensure predictability
- Field masks for targeted partial updates
- Authentication and validation methods for secure APIs
- Collective operations for moving, managing, and deleting data
- Advanced patterns for special interactions and data transformations
API Design Patterns reveals best practices for building stable, user-friendly APIs. These design patterns can be applied to solve common API problems and flexibly altered to fit your specific needs. Hands-on examples and relevant use-cases illustrate patterns for API fundamentals, advanced functionalities, and even uncommon scenarios.
Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications.
About the technology
APIs are contracts that define how applications, services, and components communicate. API design patterns provide a shared set of best practices, specifications and standards that ensure APIs are reliable and simple for other developers to use. This book collects and explains the most important patterns from both the API design community and the experts at Google.
About the book
API Design Patterns lays out a set of design principles for building internal and public-facing APIs. Google API expert JJ Geewax presents patterns that ensure your APIs are consistent, scalable, and flexible. You'll improve the design of the most common APIs, plus discover techniques for tricky edge cases. Precise illustrations, relevant examples, and detailed scenarios make every pattern clear and easy to understand.
What's inside
- Guiding principles for API patterns
- Fundamentals of resource layout and naming
- Advanced patterns for special interactions and data transformations
- A detailed case-study on building an API and adding features
In this Book
-
Foreword
-
About This Book
-
Introduction to APIs
-
Introduction to API Design Patterns
-
Naming
-
Resource Scope and Hierarchy
-
Data Types and Defaults
-
Resource Identification
-
Standard Methods
-
Partial Updates and Retrievals
-
Custom Methods
-
Long-Running Operations
-
Rerunnable Jobs
-
Singleton Sub-Resources
-
Cross References
-
Association Resources
-
Add and Remove Custom Methods
-
Polymorphism
-
Copy and Move
-
Batch Operations
-
Criteria-Based Deletion
-
Anonymous Writes
-
Pagination
-
Filtering
-
Importing and Exporting
-
Versioning and Compatibility
-
Soft Deletion
-
Request Deduplication
-
Request Validation
-
Resource Revisions
-
Request Retrial
-
Request Authentication
