Principles of Web API Design
Home > Computing and Information Technology > Computer networking and communications > WAP networking and applications > Principles of Web API Design: Delivering Value with APIs and Microservices
Principles of Web API Design: Delivering Value with APIs and Microservices

Principles of Web API Design: Delivering Value with APIs and Microservices

|
     0     
5
4
3
2
1




Out of Stock


Notify me when this book is in stock
About the Book

The Full-Lifecycle Guide to API Design Principles of Web API Design brings together principles and processes to help you succeed across the entire API design lifecycle. Drawing on extensive in-the-trenches experience, leading consultant James Higginbotham helps you align every stakeholder on specific outcomes, design APIs that deliver value, and scale the design process from small teams to the entire organization. Higginbotham helps you bring an "outside-in" perspective to API design to reflect the voices of customers and product teams, map requirements to specific and well-organized APIs, and choose the right API style for writing them. He walks through a real-world example from the ground up, offering guidance for anyone designing new APIs or extending existing APIs. Deliver great APIs by getting your design processes right Gain agreement on specific outcomes from design teams, customers, and other stakeholders Craft job stories, conduct EventStorming, and model capabilities Identify the right APIs, and organize operations into coherent API profiles Choose the best styles for each project: REST, gRPC, GraphQL, or event-based async APIs Refine designs based on feedback from documenters, testers, and customers Decompose APIs into microservices Mature your API program, implementing design and management processes that scale This guide is invaluable for anyone involved in planning or building APIs--architects, developers, team leaders, managers in single and multi-team environments, and any technical or business professional delivering "API-as-a-product" offerings. Register your book for convenient access to downloads, updates, and/or corrections as they become available. See inside book for details.

Table of Contents:
Series Editor Foreword xxi Foreword xxv Preface xxvii Acknowledgments xxxi About the Author xxxiii Part I: Introduction to Web API Design 1 Chapter 1: The Principles of API Design 3 The Elements of Web API Design 4 API Design Is Communication 6 Reviewing the Principles of Software Design 7 Resource-Based API Design 10 Resources Are Not Object or Domain Models 11 Resource-Based APIs Exchange Messages 12 The Principles of Web API Design 13 Summary 14 Chapter 2: Collaborative API Design 15 Why an API Design Process? 15 API Design Process Antipatterns 16 The API Design-First Approach 20 Remaining Agile with API Design-First 22 The Align-Define-Design-Refine Process 23 The Role of DDD in API Design 26 API Design Involves Everyone 26 Applying the Process Effectively 28 Summary 28 Part II: Aligning on API Outcomes 29 Chapter 3: Identify Digital Capabilities 31 Ensuring Stakeholder Alignment 32 What Are Digital Capabilities? 33 Focusing on the Jobs to Be Done 34 What Are Job Stories? 35 The Components of a Job Story 36 Writing Job Stories for APIs 37 Overcoming Job Story Challenges 38 Techniques for Capturing Job Stories 40 A Real-World API Design Project 41 Job Story Examples 42 Summary 42 Chapter 4: Capture Activities and Steps 45 Extending Job Stories into Activities and Steps 46 Using EventStorming for Collaborative Understanding 49 How EventStorming Works 50 The Benefits of EventStorming 58 Facilitating an EventStorming Session 60 Customizing the Process 64 Summary 65 Part III: Defining Candidate APIs 67 Chapter 5: Identifying API Boundaries 69 Avoiding API Boundary Antipatterns 70 Bounded Contexts, Subdomains, and APIs 72 Finding API Boundaries Using EventStorming 73 Finding API Boundaries through Activities 73 Naming and Scoping APIs 75 Summary 78 Chapter 6: API Modeling 79 What Is API Modeling? 80 The API Modeling Process 81 Validating the API Model with Sequence Diagrams 93 Evaluating API Priority and Reuse 95 Summary 96 Part IV: Designing APIs 99 Chapter 7: REST-Based API Design 101 What Is a REST-Based API? 102 REST API Design Process 112 Selecting a Representation Format 125 Common REST Design Patterns 132 Summary 136 Chapter 8: RPC and Query-Based API Design 137 What Is an RPC-Based API? 138 RPC API Design Process 142 What Is a Query-Based API? 146 Query-Based API Design Process 150 Summary 157 Chapter 9: Async APIs for Eventing and Streaming 159 The Problem with API Polling 160 Async APIs Create New Possibilities 161 A Review of Messaging Fundamentals 162 Async API Styles 171 Designing Async APIs 178 Documenting Async APIs 184 Summary 186 Part V: Refining the API Design 187 Chapter 10: From APIs to Microservices 189 What Are Microservices? 190 Microservices Reduce Coordination Costs 192 The Difference between APIs and Microservices 193 Weighing the Complexity of Microservices 193 Synchronous and Asynchronous Microservices 198 Microservice Architecture Styles 201 Right-Sizing Microservices 204 Decomposing APIs into Microservices 204 Considerations When Transitioning to Microservices 210 Summary 211 Chapter 11: Improving the Developer Experience 213 Creating a Mock API Implementation 214 Providing Helper Libraries and SDKs 219 Offering CLIs for APIs 221 Summary 224 Chapter 12: API Testing Strategies 225 Acceptance Testing 226 Automated Security Testing 226 Operational Monitoring 227 API Contract Testing 227 Selecting Tools to Accelerate Testing 229 The Challenges of API Testing 230 Make API Testing Essential 231 Summary 231 Chapter 13: Document the API Design 233 The Importance of API Documentation 234 API Description Formats 234 Extending Docs with Code Examples 248 From Reference Docs to a Developer Portal 251 Effective API Documentation 253 The Minimum Viable Portal 256 Tools and Frameworks for Developer Portals 259 Summary 260 Chapter 14: Designing for Change 261 The Impact of Change on Existing APIs 261 API Versioning Strategies 264 Deprecating APIs 268 Establishing an API Stability Contract 270 Summary 271 Chapter 15: Protecting APIs 273 The Potential for API Mischief 273 Essential API Protection Practices 274 Components of API Protection 276 API Gateway Topologies 279 Identity and Access Management 284 Considerations before Building an In-House API Gateway 289 Summary 291 Chapter 16: Continuing the API Design Journey 293 Establishing an API Style Guide 293 Conducting API Design Reviews 297 Developing a Culture of Reuse 300 The Journey Has Only Begun 301 Appendix: HTTP Primer 303 Index 319


Best Sellers


Product Details
  • ISBN-13: 9780137355730
  • Publisher: Pearson Education (US)
  • Publisher Imprint: Addison Wesley
  • Language: English
  • Sub Title: Delivering Value with APIs and Microservices
  • ISBN-10: 0137355734
  • Publisher Date: 13 Jan 2022
  • Binding: Digital download
  • No of Pages: 368


Similar Products

Add Photo
Add Photo

Customer Reviews

REVIEWS      0     
Click Here To Be The First to Review this Product
Principles of Web API Design: Delivering Value with APIs and Microservices
Pearson Education (US) -
Principles of Web API Design: Delivering Value with APIs and Microservices
Writing guidlines
We want to publish your review, so please:
  • keep your review on the product. Review's that defame author's character will be rejected.
  • Keep your review focused on the product.
  • Avoid writing about customer service. contact us instead if you have issue requiring immediate attention.
  • Refrain from mentioning competitors or the specific price you paid for the product.
  • Do not include any personally identifiable information, such as full names.

Principles of Web API Design: Delivering Value with APIs and Microservices

Required fields are marked with *

Review Title*
Review
    Add Photo Add up to 6 photos
    Would you recommend this product to a friend?
    Tag this Book Read more
    Does your review contain spoilers?
    What type of reader best describes you?
    I agree to the terms & conditions
    You may receive emails regarding this submission. Any emails will include the ability to opt-out of future communications.

    CUSTOMER RATINGS AND REVIEWS AND QUESTIONS AND ANSWERS TERMS OF USE

    These Terms of Use govern your conduct associated with the Customer Ratings and Reviews and/or Questions and Answers service offered by Bookswagon (the "CRR Service").


    By submitting any content to Bookswagon, you guarantee that:
    • You are the sole author and owner of the intellectual property rights in the content;
    • All "moral rights" that you may have in such content have been voluntarily waived by you;
    • All content that you post is accurate;
    • You are at least 13 years old;
    • Use of the content you supply does not violate these Terms of Use and will not cause injury to any person or entity.
    You further agree that you may not submit any content:
    • That is known by you to be false, inaccurate or misleading;
    • That infringes any third party's copyright, patent, trademark, trade secret or other proprietary rights or rights of publicity or privacy;
    • That violates any law, statute, ordinance or regulation (including, but not limited to, those governing, consumer protection, unfair competition, anti-discrimination or false advertising);
    • That is, or may reasonably be considered to be, defamatory, libelous, hateful, racially or religiously biased or offensive, unlawfully threatening or unlawfully harassing to any individual, partnership or corporation;
    • For which you were compensated or granted any consideration by any unapproved third party;
    • That includes any information that references other websites, addresses, email addresses, contact information or phone numbers;
    • That contains any computer viruses, worms or other potentially damaging computer programs or files.
    You agree to indemnify and hold Bookswagon (and its officers, directors, agents, subsidiaries, joint ventures, employees and third-party service providers, including but not limited to Bazaarvoice, Inc.), harmless from all claims, demands, and damages (actual and consequential) of every kind and nature, known and unknown including reasonable attorneys' fees, arising out of a breach of your representations and warranties set forth above, or your violation of any law or the rights of a third party.


    For any content that you submit, you grant Bookswagon a perpetual, irrevocable, royalty-free, transferable right and license to use, copy, modify, delete in its entirety, adapt, publish, translate, create derivative works from and/or sell, transfer, and/or distribute such content and/or incorporate such content into any form, medium or technology throughout the world without compensation to you. Additionally,  Bookswagon may transfer or share any personal information that you submit with its third-party service providers, including but not limited to Bazaarvoice, Inc. in accordance with  Privacy Policy


    All content that you submit may be used at Bookswagon's sole discretion. Bookswagon reserves the right to change, condense, withhold publication, remove or delete any content on Bookswagon's website that Bookswagon deems, in its sole discretion, to violate the content guidelines or any other provision of these Terms of Use.  Bookswagon does not guarantee that you will have any recourse through Bookswagon to edit or delete any content you have submitted. Ratings and written comments are generally posted within two to four business days. However, Bookswagon reserves the right to remove or to refuse to post any submission to the extent authorized by law. You acknowledge that you, not Bookswagon, are responsible for the contents of your submission. None of the content that you submit shall be subject to any obligation of confidence on the part of Bookswagon, its agents, subsidiaries, affiliates, partners or third party service providers (including but not limited to Bazaarvoice, Inc.)and their respective directors, officers and employees.

    Accept

    New Arrivals

    Inspired by your browsing history


    Your review has been submitted!

    You've already reviewed this product!