https://github.com/reprezen/openapi-v3-workshop
Hands-On OpenAPI 3.0 examples, exercises & reference materials
https://github.com/reprezen/openapi-v3-workshop
Last synced: 4 months ago
JSON representation
Hands-On OpenAPI 3.0 examples, exercises & reference materials
- Host: GitHub
- URL: https://github.com/reprezen/openapi-v3-workshop
- Owner: RepreZen
- Created: 2019-05-13T17:19:16.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-05-13T17:25:48.000Z (about 6 years ago)
- Last Synced: 2025-01-20T16:32:53.093Z (5 months ago)
- Size: 30.3 KB
- Stars: 1
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
.png)
# OpenAPI v3 Hands-On Workshop Exercises
This project has exercises and solutions for the OpenAPI Hands-On 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
There are many commercial and open source editors for OpenAPI. You can work with the following tools, or any other editing environment that supports OpenAPI 3.0. We recommand using a tool with a side-by-side editor and documentation view.
### RepreZen API Studio
* [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) :
* 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.