Introduction to OpenAPI
You need to be signed in to add a collection
Open API Specification is a machine and human readable way to describe APIs. From these specs we can generate documentation, create libraries, and ensure that our users know exactly what to expect from our APIs.<br /> This talk shows you around OAS from the beginning, showing how to create the specs and recommending some tools to help the process. Once you have the spec, things get interesting and this talk will showcase some of the things that you can offer once your API is described in this way. This session is recommended for writers looking to become more API-savvy and API engineers wanting to make their APIs more useful to their users. **What will the audience learn from this talk?** Attendees will learn about describing their APIs using OpenAPI specification, and what can be produced from the descriptions, such as documentation, tests, and even code. **Does it feature code examples and/or live coding?** Code and spec examples are included (in large font for illustration purposes), but no live coding. **Prerequisite attendee experience level:** Level [100](https://gotocph.com/2019/pages/experience-level)
Transcript
Open API Specification is a machine and human readable way to describe APIs. From these specs we can generate documentation, create libraries, and ensure that our users know exactly what to expect from our APIs.
This talk shows you around OAS from the beginning, showing how to create the specs and recommending some tools to help the process. Once you have the spec, things get interesting and this talk will showcase some of the things that you can offer once your API is described in this way.
This session is recommended for writers looking to become more API-savvy and API engineers wanting to make their APIs more useful to their users.
What will the audience learn from this talk? Attendees will learn about describing their APIs using OpenAPI specification, and what can be produced from the descriptions, such as documentation, tests, and even code.
Does it feature code examples and/or live coding? Code and spec examples are included (in large font for illustration purposes), but no live coding.
Prerequisite attendee experience level: Level 100
About the speakers
Head of Developer Advocate at Aiven, writer for a number of outlets