Home Conference Sessions Introduction to ...

Introduction to OpenAPI

Lorna Jane Mitchell | GOTO Copenhagen 2019

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)

Share on:
linkedin facebook
Copied!

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

Lorna Jane Mitchell

Lorna Jane Mitchell

Head of Developer Advocate at Aiven, writer for a number of outlets