About this item:
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
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
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
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.
Visit the Manning Publications Store
BHD32136
Quantity:
Order today to get by
Free delivery on orders over BHD 20
Product origin: United Kingdom
Or share with link
https://bolo.com/