Learn OpenAPI
The official introduction to the OpenAPI Specification from the OpenAPI Initiative, explaining the structure of an API description document: paths, operations, parameters, request bodies, responses, components and reuse, with best practices. It is the right place to start before writing or generating specs, since most tutorials skip the reasoning. Short enough to read in an evening.
Guide
Web Development
OpenAPI Initiative
An evening
Beginner
Free
The official introduction to the OpenAPI Specification from the OpenAPI Initiative, explaining the structure of an API description document: paths, operations, parameters, request bodies, responses, components and reuse, with best practices. It is the right place to start before writing or generating specs, since most tutorials skip the reasoning. Short enough to read in an evening.
Ready to start?
Opens on OpenAPI Initiative in a new tab.
Stuck on something specific?
Writing only gets you so far. If you want an answer to your situation rather than the general case, book a session and we will work through it together. Sessions are free for approved Sefism members, and a few slots open each week.
Follow along
New writing, resources and project ideas land here first.