Designing APIs with Swagger and OpenAPI

Description:

About this item:

Using standards like OpenAPI, you can provide reliable, easy-to-use interfaces that allow other developers safe, controlled access to your software. Designing APIs withSwagger and OpenAPIis a hands-on primer to properly designing and describing your APIs using the most widely-adopted standard.

Designing APIswith Swagger and OpenAPI introduces you to a design-first paradigm that will teach you the best practices for describing and designing RESTful APIs using OpenAPI and Swagger. You'll build upon progressively-enhanced examples as you learn to describe an API andthen extend it in the kind of scenarios you'd encounter in the real world. As you go, you'll use the popular Open Source tools to define APIs, generate documentation, and build other developer-friendly components like mocks, server stubs, and client SDKs.

Modern web applications are made of multiple components, services, and servers connected through APIs, often using HTTP and REST as their primary interfaces. These architectures rely on APIs that allow access to the functionality of a component without requiring developers to understand the details of how it was implemented. The OpenAPI specification standardizes how you describe RESTful APIs. OpenAPI is vendor-neutral and has been adopted bybig tech companies such as Google, Microsoft, and Amazon.

Review

“A great introduction to the design process of APIs by helping youto understand OpenAPI and Swagger.” Ben McNamara

“The book's instructional design was very well thought out.Instructions are clear and the topics flow quite smoothly.” Ted Hagos

“I would recommend this book to anyone interested in learningabout API design!” Travis Wisnasky

From the Back Cover

Designing APIs with Swagger and OpenAPI is a hands-on primer for describing, planning and designing web APIs. Core Swagger contributor Josh Ponelat introduces you to a design-first paradigm that will teach you the best practices for describing and designing RESTful APIsusing OpenAPI and Swagger. You'll build upon progressively-enhanced examples asyou learn to describe an API and then extend it in the kind of scenarios you'dencounter in the real world. You'll practice skills for assessing business needs, gathering requirements, and working with a cross-functional team. And as you go, you'll use the popular Open Source tools to define APIs, generate documentation, and build other developer-friendly components like mocks, serverstubs, and client SDKs.

Review:

5.0 out of 5

100.00% of customers are satisfied

5.0 out of 5 stars A Great Read for Tech and Product Folks New to API Design or OpenAPI

J.S.G. · 8 January 2025

This is a great book for anyone who wants to learn all about OpenAPI and Swagger UI in detail, and/or wants to learn how to create a new REST API in a design-first way (I wouldn't recommend it to experienced devs unless you're new to OpenAPI).The book is broken into 3 sections. The 1st section uses an simple example API to walk thru the essential basics of REST APIs, the OpenAPI YAML format and functionality, and using Swagger Editor. The 2nd and 3rd sections use a narrative structure to teach readers how to design a new API from scratch, from concept thru public release. The story is of a fictional small dev team which is building a new API/business which aims to connect pet owners with people to pet-sit for them (i.e. walk their dog, feed their cat, etc.).I was expecting this to be a technical book, and it has a fair amount of that (mostly around OpenAPI YAML schemas, but also some basic example JavaSCript code for client- and server-side implementations). However, the authors surprised me by really going deeply into the initial design-phase of their fictional project, in which their functional team uses a loosely domain driven design approach (DDD) starting with modeling API domain objects, then translating those into schemas and operations (as REST endpoints), then finally into OpenAPI schema components for the example REST API, all step-by-step.My only complaint about this book, as a developer that's mainly focused on the technical side of things, is that the authors really indulge in their narrative. Pages and pages of content around this imaginary dev team and their internal design process could be cut from this book, as it's all story telling and not technically relevant. However, those many pages actually do do a great job of illustrating the various design decisions and trade-offs that one is likely to encounter when designing your own API – so I think that writing style will make this book a great read for both junior devs and non-technical folks with an interest in the topic (it makes the content more accessible, between all the really solid OAS YAML schema examples, etc.). ...By the 3rd section, I got used to skimming over large sections of the book to get to the next technically useful part, to be honest. You may read or skip the extensive story arc at your own discretion. ;-)Final word – this is a great book for any technical or product person wanting to learn all about OpenAPI, Swagger, and how to approach designing a REST API from the ground up. Enjoy!

A journey to design an API

S.N. · 5 April 2024

The book contains 3 parts.In the first part (approx. 120 pages) you will learn the basic structure of an OpenAPI document.In the second part (approx. 140 pages) you get a practical guide to design an API. You will learn how to collaborate with several stakeholders to achieve a design first API.The third part (approx. 120 pages) dives deeper in advanced topics like versioning an API, polymorphism, ...The texts are fun to read. The examples are very clear. After reading you will not only have learned about the OpenAPI spec, but also have gathered a complete toolbox to put in into practice.

Ein sehr gutes Fachbuch

A.C. · 13 October 2023

Dieses Buch ist sehr empfehlenswert, wenn man sich noch nicht mit Swagger und OpenAPI beschäftigt hat. Es ist sehr gut geschrieben und didaktisch super aufgebaut. Die Erklärungen sind ausführlich und es macht einfach Spaß das Buch zu lesen. Auf jeden Fall sollte man die Beispiele aus dm Buch durchzuarbeiten, damit man den maximalen Lernerfolg hat. Ich habe schon sehr lange kein so gutes Buch mehr gelesen. Daher alle 5++ Sterne.

Designing APIs with Swagger and OpenAPI

4.9

BHD32136

Quantity:

|

Order today to get by

Free delivery on orders over BHD 20

Return and refund policies

Product origin: United Kingdom

All product information listed on the site are from 3rd party sources, including images and reviews. bolo.bh is not liable for any claims or promotions mentioned on the product description or images with textual content. For detailed product information, please contact the manufacturer or Bolo support by logging into your account. Unless stated otherwise during checkout, all import taxes and duty are included in the price mentioned on the product page. bolo.bh follows the rules and regulations of sale in Bahrain and will cancel items in an order that are illegal for sale in Bahrain. We take all the necessary steps to ensure only products for sale in Bahrain are displayed. Product stock and delivery estimate may change with the seller even after placing the order. All items are shipped by air and items marked “Dangerous Goods (DG)” by the IATA will be cancelled from orders. We strive to process your order as soon as it is finalized.

Similar suggestions by Bolo

More from this brand

Similar items from “Systems Analysis & Design”