OpenAPI 3.0: From Idea to Implementation скачать в хорошем качестве

OpenAPI 3.0: From Idea to Implementation

Welcome to the 2023 season of Postman LIVE! In this week's episode, "OpenAPI 3.0: From Idea to Implementation", Senior Developer Advocate, Ian Douglas has invited API Governance Lead, Arnaud Lauret to guide us on a journey through OpenAPI 3.0, from zero to hero. Starting OpenAPI from a blank page, Arnaud will help us learn about API design and give us an overview of the YAML that makes up our OpenAPI schema. We will talk about OpenAPI vs Swagger and finally taking our new API design through to implementation. 🔗 File copy used during the live stream: https://github.com/postmanlabs/livest... -- available soon! 📌 Timestamps 00:00 Start 01:00 Introductions 02:55 Arnaud's background in API design 04:20 What is OpenAPI and how is it used in API design? 06:04 In Case You Missed It 08:40 Building an API from an empty page, and thinking about the business needs so we only design what we need 15:56 Getting started with OpenAPI version and "info" block 22:42 Defining the "servers" section and best practices around versioning your API using the URI path of a URL 27:40 Defining our OpenAPI "paths" and putting a placeholder for "components" that we'll fill in later 31:22 Adding an API path to search for books, API design discussion and HTTP verbs 37:47 Adding a "summary" to our GET operation, and status codes 44:00 discussion about response data types, and how to structure that data to allow future-proofing our API 53:30 Which attributes should we return for a list of books? Discussion of RESTful design over-fetching and under-fetching 1:02:10 Discussion about what an "ID" field should contain: what does our tech stack define, versus user expectation 1:08:44 Finishing our schema and converting it to an OpenAPI "component" for re-use 1:21:20 Discussion about reusing schemas in an embedded way to extend schemas 1:22:45 Adding an example definition in OpenAPI 1:28:52 Community Shoutouts