Patterns for API Design
Home > Computing and Information Technology > Computer programming / software engineering > Web programming > Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges
Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges

Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges

|
     0     
5
4
3
2
1




International Edition


About the Book

Proven Patterns for Designing Evolvable High-Quality APIs--For Any Domain, Technology, or Platform APIs enable breakthrough innovation and digital transformation in organizations and ecosystems of all kinds. To create user-friendly, reliable and well-performing APIs, architects, designers, and developers need expert design guidance. This practical guide cuts through the complexity of API conversations and their message contents, introducing comprehensive guidelines and heuristics for designing APIs sustainably and specifying them clearly, for whatever technologies or platforms you use. In Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges, five expert architects and developers cover the entire API lifecycle, from launching projects and establishing goals through defining requirements, elaborating designs, planning evolution, and creating useful documentation. They crystallize the collective knowledge of many practitioners into 44 API design patterns, consistently explained with context, pros and cons, conceptual solutions, and concrete examples. To make their pattern language accessible, they present a domain model, a running case study, decision narratives with pattern selection options and criteria, and walkthroughs of real-world projects applying the patterns in two different industries. Identify and overcome API design challenges with patterns Size your endpoint types and operations adequately Design request and response messages and their representations Refine your message design for quality Plan to evolve your APIs Document and communicate your API contracts Combine patterns to solve real-world problems and make the right tradeoffs "This book provides a healthy mix of theory and practice, containing numerous nuggets of deep advice but never losing the big picture . . . grounded in real-world experience and documented with academic rigor applied and practitioner community feedback incorporated. I am confident that [it] will serve the community well, today and tomorrow." --Prof. Dr. Dr. h. c. Frank Leymann, Managing Director, Institute of Architecture of Application Systems, University of Stuttgart

Table of Contents:
Foreword by Vaughn Vernon, Series Editor     xvii Foreword by Frank Leymann     xxi Preface     xxiii   Part 1: Foundations and Narratives     1 Chapter 1: Application Programming Interface (API) Fundamentals     3      From Local Interfaces to Remote APIs     3      Decision Drivers in API Design     14      A Domain Model for Remote APIs     22      Summary     28   Chapter 2: Lakeside Mutual Case Study     31      Business Context and Requirements     31      Architecture Overview     35      API Design Activities     39      Target API Specification     39      Summary     41   Chapter 3: API Decision Narratives     43      Prelude: Patterns as Decision Options, Forces as Decision Criteria     43      Foundational API Decisions and Patterns     45      Decisions about API Roles and Responsibilities     57      Selecting Message Representation Patterns     70      Interlude: Responsibility and Structure Patterns in the Lakeside Mutual Case     82      Governing API Quality     84      Deciding for API Quality Improvements     98      Decisions about API Evolution     110      Summary     122   Part 2: The Patterns     125 Chapter 4: Pattern Language Introduction      127      Positioning and Scope     128      Patterns: Why and How?     130      Navigating through the Patterns     131      Foundations: API Visibility and Integration Types     137      Basic Structure Patterns     146      Summary     158   Chapter 5: Define Endpoint Types and Operations     161      Introduction to API Roles and Responsibilities     162      Endpoint Roles (aka Service Granularity)     167      Operation Responsibilities     215      Summary     248   Chapter 6: Design Request and Response Message Representations     253      Introduction to Message Representation Design     253      Element Stereotypes     256      Special-Purpose Representations     282      Summary                                                 305   Chapter 7: Refine Message Design for Quality  309      Introduction to API Quality     309      Message Granularity     313      Client-Driven Message Content (aka Response Shaping)     325 Message Exchange Optimization (aka Conversation Efficiency)     344 Summary     355   Chapter 8: Evolve APIs     357 Introduction to API Evolution     357 Versioning and Compatibility Management     362 Life-Cycle Management Guarantees     374 Summary     393   Chapter 9: Document and Communicate API Contracts     395 Introduction to API Documentation     395 Documentation Patterns     398 Summary     421     Part 3: Our Patterns in Action (Now and Then)     423 Chapter 10: Real-World Pattern Stories     425 Large-Scale Process Integration in the Swiss Mortgage Business     426 Offering and Ordering Processes in Building Construction     438 Summary     445   Chapter 11: Conclusion     447 Short Retrospective     448 API Research: Refactoring to Patterns, MDSL, and More     449 The Future of APIs     450 Additional Resources     451 Final Remarks     451   Appendix A: Endpoint Identification and Pattern Selection Guides     453 Appendix B: Implementation of the Lakeside Mutual Case     463 Appendix C: Microservice Domain-Specific Language (MDSL)     471   Bibliography     483 Index     499


Best Sellers


Product Details
  • ISBN-13: 9780137670109
  • Publisher: Pearson Education (US)
  • Publisher Imprint: Addison Wesley
  • Height: 230 mm
  • No of Pages: 544
  • Spine Width: 30 mm
  • Weight: 911 gr
  • ISBN-10: 0137670109
  • Publisher Date: 26 Jan 2023
  • Binding: Paperback
  • Language: English
  • Returnable: Y
  • Sub Title: Simplifying Integration with Loosely Coupled Message Exchanges
  • Width: 178 mm


Similar Products

Add Photo
Add Photo

Customer Reviews

REVIEWS      0     
Click Here To Be The First to Review this Product
Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges
Pearson Education (US) -
Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges
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.

Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges

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!