動画検索
関連広告
検索結果
Start
Introductions
Arnaud's background in API design
What is OpenAPI and how is it used in API design?
In Case You Missed It
Building an API from an empty page, and thinking about the business needs so we only design what we need
Getting started with OpenAPI version and "info" block
Defining the "servers" section and best practices around versioning your API using the URI path of a URL
Defining our OpenAPI "paths" and putting a placeholder for "components" that we'll fill in later
Adding an API path to search for books, API design discussion and HTTP verbs
Adding a "summary" to our GET operation, and status codes
discussion about response data types, and how to structure that data to allow future-proofing our API
Which attributes should we return for a list of books? Discussion of RESTful design over-fetching and under-fetching
Discussion about what an "ID" field should contain: what does our tech stack define, versus user expectation
Finishing our schema and converting it to an OpenAPI "component" for re-use
Discussion about reusing schemas in an embedded way to extend schemas
Adding an example definition in OpenAPI
Community Shoutouts