防詐3要訣：不聽信、不操作、掛斷電話 
RESTful API Design Patterns and Best Practices: Master REST API design with real-world patterns, lifecycle management, and OpenAPI practices
RESTFUL API DESIGN PATTERNS &
內容簡介
Learn how to build robust, future-proof APIs by applying the latest industry best practices, avoiding common pitfalls, and understanding anti-patterns
Free with your book: DRM-free PDF version + access to Packt's next-gen Reader*
Key Features:
- Design APIs with your audience in mind to improve usability, lifecycle management, and communication
- Learn how to create a client-centric REST API design leveraging OpenAPI and JSON Schema
- Explore API versioning strategies, and gain hands-on experience with API testing and implementation
- Purchase of the print or Kindle book includes a free PDF eBook
Book Description:
Designing scalable, user-focused, and robust APIs that last isn't just a technical challenge but a design imperative. Written by API leaders with over 30 years of combined experience in API strategy, governance, and community, this book is your comprehensive guide to API design, focusing on domain-driven, consumer-centric APIs that meet real user needs while remaining flexible and maintainable over time. It covers modern REST API design, tools like OpenAPI and JSON Schema, and the importance of a product-based approach. The chapters help you explore best practices, potential pitfalls, and anti-patterns, extending beyond the design phase.
Starting with the "why" behind building an API, its intended users, and value, this book walks you through the API lifecycle, the role of contracts, and applying domain-driven design. You'll develop a solid foundation in REST API design as you discover different styles, constraints, and more. Beyond design, the book covers testing techniques, API evolution, maintenance, and deprecation.
By the end, you'll not only know how to design great APIs but understand how to treat them as products, manage their lifecycle, and deliver real value by keeping your APIs relevant and reliable long after release.
*Email sign-up and proof of purchase required
What You Will Learn:
- Assess your client's needs to design APIs that communicate the value of your product
- Understand the role of API lifecycle and the importance of contracts
- Apply domain-driven design principles in API architecture
- Embrace a modern approach to REST API design
- Use the OpenAPI Specification and JSON Schema for standardized APIs
- Evolve, maintain, and deprecate your APIs without disrupting your users
Who this book is for:
This book is for professionals involved in the digital product lifecycle who want to deepen their understanding of API design and build future-proof APIs with a product-centric approach. API developers, solution architects and engineers, technical product owners, and software architects looking to extend their skills in creating efficient, scalable, and maintainable APIs will find this book particularly useful. Basic knowledge of APIs and the HTTP protocol is recommended to fully benefit from the design principles and practices covered.
Table of Contents
- The "Why" of API Development
- API as a Product: Designing APIs with a Product Mindset
- Understanding Application and API Lifecycles
- Applying Domain-Driven Design to APIs
- Comparing and Choosing the Right API Style
- REST Design Constraints and Maturity Models
- Constructing an API Design Domain Model
- Designing and Managing Effective API Contracts
- Understanding the OpenAPI Specification
- OpenAPI as a Contract: Best Practices and Implementation
- Using JSON Schema to Define Your Object Models
- Don't Hate Your Hypermedia: Creating APIs For Humans and AIs
- API Change Management: Strategies for Versioning and Evolution
規格
退貨說明
退貨須知：
- 依照消費者保護法的規定，您享有商品貨到次日起七天猶豫期(含例假日)的權益(請注意！猶豫期非試用期)，辦理退貨之商品必須是全新狀態(不得有刮傷、破損、受潮)且需完整(包含全部商品、配件、原廠內外包裝、贈品及所有附隨文件或資料的完整性等)。
- 請您以送貨廠商使用之包裝紙箱將退貨商品包裝妥當，若原紙箱已遺失，請另使用其他紙箱包覆於商品原廠包裝之外，切勿直接於原廠包裝上黏貼紙張或書寫文字。若原廠包裝損毀將可能被認定為已逾越檢查商品之必要程度，本公司得依毀損程度扣除回復原狀必要費用(整新費)後退費；請您先確認商品正確、外觀可接受，再行拆封，以免影響您的權利；若為產品瑕疵，本公司接受退貨。
依「通訊交易解除權合理例外情事適用準則」，下列商品不適用七日猶豫期，除產品本身有瑕疵外，不接受退貨：
- 易於腐敗、保存期限較短或解約時即將逾期。(如:生鮮蔬果、乳製品、冷凍冷藏食材、蛋糕)
- 依消費者要求所為之客製化給付。(如:客製印章、鋼筆刻字)
- 報紙、期刊或雜誌。
- 經消費者拆封之影音商品或電腦軟體。
- 非以有形媒介提供之數位內容或一經提供即為完成之線上服務，經消費者事先同意始提供。(如:電子書)
- 已拆封之個人衛生用品。(如:內衣褲、襪類、褲襪、刮鬍刀、除毛刀等貼身用品)
- 國際航空客運服務。
若您退貨時有下列情形，可能被認定已逾越檢查商品之必要程度而須負擔為回復原狀必要費用(整新費)，或影響您的退貨權利，請您在拆封前決定是否要退貨：
- 以數位或電磁紀錄形式儲存或著作權相關之商品(包含但不限於CD、VCD、DVD、電腦軟體等) 包裝已拆封者(除運送用之包裝以外)。
- 耗材(包含但不限於墨水匣、碳粉匣、紙張、筆類墨水、清潔劑補充包等)之商品包裝已拆封者(除運送用之包裝以外)。
- 衣飾鞋類/寢具/織品(包含但不限於衣褲、鞋子、襪子、泳裝、床單、被套、填充玩具)或之商品缺件(含購買商品、附件、內外包裝、贈品等)或經剪標或下水或商品有不可回復之髒污或磨損痕跡。
- 食品、美容/保養用品、內衣褲等消耗性或個人衛生用品、商品銷售頁面上特別載明之商品已拆封者(除運送用之包裝外一切包裝、包括但不限於瓶蓋、封口、封膜等接觸商品內容之包裝部分)或已非全新狀態(外觀有刮傷、破損、受潮等)與包裝不完整(缺少商品、附件、原廠外盒、保護袋、配件紙箱、保麗龍、隨貨文件、贈品等)。
- 家電、3C、畫作、電子閱讀器等商品，除商品本身有瑕疵外，退回之商品已拆封(除運送用之包裝外一切包裝、包括但不限於封膜等接觸商品內容之包裝部分、移除封條、拆除吊牌、拆除貼膠或標籤等情形)或已非全新狀態(外觀有刮傷、破損、受潮等)與包裝不完整(缺少商品、附件、原廠外盒、保護袋、配件紙箱、保麗龍、隨貨文件、贈品等)。
- 退貨程序請參閱【客服專區→常見問題→誠品線上退貨退款】之說明。