Open API v2

Learning Resources

Only editable by group admins

  • Last updated November 10, 2018 at 11:55 AM by hankish
  • Evidence visible to group members and anyone with the link
Share links to all of the Open API learning resources which were valuable to you.
One key thing to note is that there are three versions of the OpenAPI specification. The spec was originally named "Swagger", but they rebranded in version 2. The latest version is 3 but for this badge you'll want to learn about version 2 (since this is the version we're using in the Badge List platform for now). We will eventually migrate to v3... it's not tremendously different.

Here are some links to get you started:

All posted evidence

Wikipedia page for OpenAPI spec

Wikipedia

OpenAPI Specification - Wikipedia

The OpenAPI Specification, originally known as the Swagger Specification, is a specification for machine-readable interface files for describing, producing, consuming, and visualizing RESTful web services. Originally part of the Swagger framework, it became a separate project in 2016, overseen by the OpenAPI Initiative, an open source collaborative project of the Linux Foundation.
cpr Almost 5 years ago

My favorite OpenAPI learning resources

In addition to the v2 Spec, I used the online Swagger Editor and followed these two tutorials to get an actual feel for what the Spec requires:

For the v3 OpenAPI Spec, the following resource looks promising as well:
juan8a Over 5 years ago

Great beginner tutorial (read-along)

Create Your First OpenAPI Definition with Swagger Editor | BlazeMeter

Create Your First OpenAPI Definition with Swagger Editor | BlazeMeter

OpenAPI definitions, formerly known as Swagger files, allow developers to specify the operations and metadata of their APIs in machine-readable form. This enables them to to automate various processes around the API lifecycle. We've already covered 5 reasons you should use OpenAPI/Swagger for your APIs on this blog.
guensie Over 5 years ago

The specs

couentine Over 5 years ago