Udemy
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
Development
Web Development Data Science Mobile Development Programming Languages Game Development Database Design & Development Software Testing Software Engineering Development Tools No-Code Development
Business
Entrepreneurship Communications Management Sales Business Strategy Operations Project Management Business Law Business Analytics & Intelligence Human Resources Industry E-Commerce Media Real Estate Other Business
Finance & Accounting
Accounting & Bookkeeping Compliance Cryptocurrency & Blockchain Economics Finance Finance Cert & Exam Prep Financial Modeling & Analysis Investing & Trading Money Management Tools Taxes Other Finance & Accounting
IT & Software
IT Certification Network & Security Hardware Operating Systems Other IT & Software
Office Productivity
Microsoft Apple Google SAP Oracle Other Office Productivity
Personal Development
Personal Transformation Personal Productivity Leadership Career Development Parenting & Relationships Happiness Esoteric Practices Religion & Spirituality Personal Brand Building Creativity Influence Self Esteem & Confidence Stress Management Memory & Study Skills Motivation Other Personal Development
Design
Web Design Graphic Design & Illustration Design Tools User Experience Design Game Design Design Thinking 3D & Animation Fashion Design Architectural Design Interior Design Other Design
Marketing
Digital Marketing Search Engine Optimization Social Media Marketing Branding Marketing Fundamentals Marketing Analytics & Automation Public Relations Advertising Video & Mobile Marketing Content Marketing Growth Hacking Affiliate Marketing Product Marketing Other Marketing
Lifestyle
Arts & Crafts Beauty & Makeup Esoteric Practices Food & Beverage Gaming Home Improvement Pet Care & Training Travel Other Lifestyle
Photography & Video
Digital Photography Photography Portrait Photography Photography Tools Commercial Photography Video Design Other Photography & Video
Health & Fitness
Fitness General Health Sports Nutrition Yoga Mental Health Dieting Self Defense Safety & First Aid Dance Meditation Other Health & Fitness
Music
Instruments Music Production Music Fundamentals Vocal Music Techniques Music Software Other Music
Teaching & Academics
Engineering Humanities Math Science Online Education Social Science Language Teacher Training Test Prep Other Teaching & Academics
AWS Certification Microsoft Certification AWS Certified Solutions Architect - Associate AWS Certified Cloud Practitioner CompTIA A+ Cisco CCNA Amazon AWS CompTIA Security+ Microsoft AZ-900
Graphic Design Photoshop Adobe Illustrator Drawing Digital Painting InDesign Character Design Canva Figure Drawing
Life Coach Training Neuro-Linguistic Programming Personal Development Mindfulness Personal Transformation Meditation Life Purpose Coaching Neuroscience
Web Development JavaScript React CSS Angular PHP WordPress Node.Js Python
Google Flutter Android Development iOS Development Swift React Native Dart Programming Language Mobile Development Kotlin SwiftUI
Digital Marketing Google Ads (Adwords) Social Media Marketing Google Ads (AdWords) Certification Marketing Strategy Internet Marketing YouTube Marketing Email Marketing Retargeting
SQL Microsoft Power BI Tableau Business Analysis Business Intelligence MySQL Data Analysis Data Modeling Data Science
Business Fundamentals Entrepreneurship Fundamentals Business Strategy Online Business Business Plan Startup Freelancing Blogging Home Business
Unity Game Development Fundamentals Unreal Engine C# 3D Game Development C++ Unreal Engine Blueprints 2D Game Development Blender
30-Day Money-Back Guarantee

This course includes:

  • 1 hour on-demand video
  • 3 articles
  • 10 downloadable resources
  • Full lifetime access
  • Access on mobile and TV
  • Assignments
IT & Software Other IT & Software Swagger Tools

Learn Swagger and the Open API Specification

API Definition Files, Tools, and Documentation (OAS 2.0)
Bestseller
Rating: 4.3 out of 54.3 (1,931 ratings)
10,270 students
Created by Peter Gruenbaum
Last updated 9/2020
English
English, Polish [Auto]
30-Day Money-Back Guarantee

What you'll learn

  • Read and write Open API Specification (Swagger) files to define and document APIs
  • Use Swagger tools to edit files, create documentation, and create SDKs
  • Understand alternatives to Swagger and OAS.
Curated for the Udemy for Business collection

Requirements

  • You should understand how REST APIs work
  • You should be able to read and understand JSON
  • If you need these skills, take my courses on JSON/XML and REST

Description

The Open API Specification (often called "Swagger") is currently the most popular way to create definitions of RESTful APIs. With these definitions, you can create sophisticated, autogenerated documentation, generate SDKs in several languages, and do automated testing. Swagger is a set of open source tools that use these Open API Specification definition files.

This class is for people in the software industry who are fairly technical, but are not software developers: for example, project managers, API product managers, and technical writers. It assumes that you understand REST and JSON, but that's about all. It is meant to be for people who are new to the Open API Specification and Swagger, rather than for experts. It covers:

  • What you can do with Open API Specification (OAS) files

  • The YAML file format

  • How to create an OAS file

  • How to specify security

  • How to add documentation

  • How to write an OAS file in JSON

  • Alternatives to Swagger and OAS

This class does not cover:

  • How to set up Swagger on your own server

  • How to modify Swagger open source code

In addition to videos, this course contains 8 hands-on exercises that lead you step-by-step in creating an API definition file, including a final project where you create a file from scratch using documentation from an actual commercial API. It also contains a document with resources on learning more about OAS, Swagger, and alternatives.

In addition to the video lectures, expect to spend at least 4 hours doing the exercises. These exercises are key to understanding Swagger and OAS.

Important: The course uses OAS 2. A newer version, OAS 3, is starting to be used more, but  many companies are still using OAS 2. There is a lecture that points you to the differences between OAS 2 and OAS 3.

Who this course is for:

  • Anyone who wants to be able to read or write Open API Specification (Swagger) files
  • Project managers
  • Technical writers
  • Technical sales staff
  • Technically-skilled managers

Featured review

Christian Villegas
Christian Villegas
33 courses
10 reviews
Rating: 5.0 out of 57 months ago
The instructor made sure that each topics are discussed in a concise manner. Each video is not so long so it does not get boring. I am not a developer but I find the topic easy to understand and I am more confident to say that I can even write Open API specs, if needed in the future.

Course content

3 sections • 13 lectures • 1h 5m total length

  • Preview07:13
  • Preview05:33
  • YAML
    06:32
  • YAML
    3 questions
  • YAML
    1 question

  • Note about OAS 3
    00:14
  • Open API Specification Basics
    05:49
  • OAS Basics
    3 questions
  • Open API Specification Basics
    1 question
  • Schemas
    09:19
  • Schemas
    3 questions
  • Schemas
    1 question
  • Open API Specification Continued
    11:10
  • Open API Specification, Continued
    3 questions
  • Open API Specification Continued
    1 question
  • Documentation
    08:29
  • Documentation
    1 question

  • Swagger Tools
    03:26
  • SwaggerHub
    1 question
  • JSON
    02:37
  • Put It All Together
    1 question
  • Alternatives to Swagger and OAS
    04:50
  • Swagger for a Real World API
    1 question
  • Resources
    00:09
  • Bonus Lecture: Offers for Other Courses
    00:20

Instructor

Peter Gruenbaum
President, SDK Bridge
Peter Gruenbaum
  • 4.5 Instructor Rating
  • 9,036 Reviews
  • 30,202 Students
  • 6 Courses

Peter founded SDK Bridge to bring together his love of technology and writing. After 10 years as a software developer, he learned the skill of API writing at Microsoft. Since then, he has worked as an API writer to describe APIs for eCommerce, automobile traffic prediction, electric utilities, mobile phones, and tractors, just to name a few.  In addition to API and SDK documentation, he creates video tutorials for software developer audiences. Peter received his BA in Physics from the University of Chicago and his PhD in Applied Physics from Stanford University. 

  • Udemy for Business
  • Teach on Udemy
  • Get the app
  • About us
  • Contact us
  • Careers
  • Blog
  • Help and Support
  • Affiliate
  • Terms
  • Privacy policy
  • Cookie settings
  • Sitemap
  • Featured courses
Udemy
© 2021 Udemy, Inc.