Open API v3

Learning Resources

Only editable by group admins

  • Last updated November 25, 2019 at 5:40 PM by hank-holiday
  • 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. We are using the latest version which is version 3.

Here are some links to get you started:

All posted evidence

OpenAPI 3.0 Tutorial

Swaggerhub

Build, Collaborate & Integrate APIs | SwaggerHub

Join thousands of developers who use SwaggerHub to build and design great APIs. Signup or login today.
angelap About 4 years ago

I also found this series of tutorials helpful

Idratherbewriting

OpenAPI specification and Swagger

I'm giving an API documentation workshop in Los Angeles, California, on January 23, 2020. You can view details on EventBrite here. Survey: I'm collecting responses for a survey about trends in developer documentation for 2020. If you write docs for developers, please take this survey.
sdcaulley About 4 years ago

I find active examples to look at helpful when reading documentation.

good video tutorial

YouTube

OpenAPI 3.0: How to Design and Document APIs with the Latest OpenAPI Specification 3.0

The OpenAPI Specification (OAS), based on the original Swagger 2.0 specification, has emerged as the world's standard for defining and describing RESTful APIs. Learn more about OpenAPI 3.0 here: https://www.slideshare.net/smartbear_software/openapi-30-and-what-it-means-for-the-future-of-swagger Get started with OpenAPI 3.0 in SwaggerHub for free: https://swaggerhub.com/ The next version of the OAS - version 3.0 - is officially released, and comes with a host of rich, expressive capabilities for your API design and documentation.
bridgerz Over 4 years ago

simple tutorial from swagger

Swaggerhub

Build, Collaborate & Integrate APIs | SwaggerHub

Join thousands of developers who use SwaggerHub to build and design great APIs. Signup or login today.
bridgerz Over 4 years ago

The response validation pointers in this link are very helpful.

Swagger

Enums | Swagger

OAS 3 This page applies to OpenAPI 3 - the latest version of the OpenAPI Specification. If you use OpenAPI 2 (fka Swagger), visit OpenAPI 2 pages. You can use the enum keyword to specify possible values of a request parameter or a model property.
sunithabl Over 4 years ago