This Vue.js component is designed to easily browse and test a REST API described with the OpenAPI 3.0 Specification (formerly known as Swagger Specification). This component follows Google Material Design principles and relies on the Vue Material framework. It also relies on vue-resource to perform API requests.
See it in action :
npm :
$ npm install --save vue-openapi
import Vue from 'vue'
import VueMaterial from 'vue-material'
import OpenApi from 'vue-openapi'
import 'vue-material/dist/vue-material.css'
import VueResource from 'vue-resource'
import jsonApi from './swagger.json'
Vue.use(VueMaterial)
Vue.use(VueResource)
new Vue({
el: '#app',
template: '<open-api v-if="jsonApi" :api="jsonApi" md-theme="\'default\'" :query-params="queryParams" :headers="headers"></open-api>',
data: () => ({
jsonApi: jsonApi,
queryParams: {
userId: 'john_doe'
},
headers: {
api_key: 'my_api_key'
}
}),
components: {
OpenApi
}
})
Run webpack in watch mode:
npm run dev
Then open test/index.html in your browser.
To switch between examples, modify the import "jsonApi" in test/app.js.
- Awesome OpenApi 3 lists various projects related to OpenApi 3.0.x
- swagger2openapi lets you convert Swagger 2.0 definitions into OpenApi 3.0.x
This project has been inspired by the following projects :