An open API service indexing awesome lists of open source software.

https://github.com/reprezen/openapi-schema-workshop

Exercises for the OpenAPI Schema Workshop
https://github.com/reprezen/openapi-schema-workshop

Last synced: 3 months ago
JSON representation

Exercises for the OpenAPI Schema Workshop

Awesome Lists containing this project

README

          


# OpenAPI Schema Workshop Exercises
This project has exercises and solutions for the OpenAPI Schema Workshop.

Source files are in OpenAPI 3.0 format.

Workshop attendees can download or clone the repository to a writable folder to complete the exercises.

## OpenAPI Editing Tools

### RepreZen API Studio
RepreZen API Studio Desktop is recommended for this workshop.
* [API Studio Desktop](https://www.RepreZen.com/trial-offer)
Standalone API design workbench for Windows, macOS, or Linux (beta).
* [API Studio for Eclipse](https://marketplace.eclipse.org/content/reprezen-api-studio)
Plug-in for standard Eclipse IDE distributions, installed from the Eclipse Marketplace.

### Swagger (Browser-based)
The online Swagger editor will work as an alternative.
* https://editor.swagger.io

## Workspace Setup

### RepreZen API Studio Setup
1. Go to **File > Switch Workspace > Other...** and select the `/workspace` folder from your local repo.


2. Activate the Project Explorer view.
Hint: You can restore the Project Explorer from minimized state by clicking the restore button in the trim stack:  


3. If you don't see the exercise projects, import the projects as follows:
* Go to **File > Import > General > Existing projects into workspace**
* Click Browse...
* Click OK
* Select all projects, and click Finish

Watch the [videos here](https://products.reprezen.com/misc/getting_started_oas.html) or on [YouTube](https://www.youtube.com/watch?v=aYYChcU2oJI&list=PLLMXvAoF1MNYQUezbEEEFfL5Lt8EXTOSg) to get started.

### Swagger Setup

You may import or copy-and-paste the exercises and answers into the Swagger Editor.