api-console
Advanced tools
An API console for RAML (Restful Api Modeling Language) documents. The RAML Console allows browsing of API documentation and in-browser testing of API methods.
There are two ways you can include the console: directly, or within an iframe. The direct method is seamless but has the potential of CSS and JS conflicts. Using an iframe avoids conflicts, but has its own quirks noted below.
Include the packaged CSS and JS in your document
<head>
…
<link href="styles/vendor.css" rel="stylesheet" type="text/css">
<link rel="stylesheet" href="path/to/dist/styles/light-theme.css" type="text/css" />
</head>
<body ng-app="ramlConsoleApp" ng-cloak>
…
<script src="path/to/dist/scripts/vendor.js"></script>
<script type="text/javascript" src="scripts/api-console.js"></script>
<script type="text/javascript">
$.noConflict();
</script>
</body>
Include the <raml-console-loader> directive, specifying your RAML as a src attribute.
Please ensure that the container for the console directive provides the CSS properties overflow: auto and position: relative.
The CSS for the console is namespaced so that it won't affect other parts of the page it's included on. However, general styles you have (such as on h1s) may inadvertently bleed into the console.
The console's javascript includes various dependencies, for example AngularJS and jQuery. If your document requires different versions or includes conflicting libraries, your page may break.
Within the page that you would like to include the console into, add the following:
<iframe src="path/to/dist/index.html?raml=path/to/your.api.raml"/>
You will need to specify a fixed height for the iframe that fits into the design of your page. Since iframes do not automatically resize to fit content, the user may have to scroll within the iframe.
A proxy for Try It can be provided after loading the console JavaScript. For example:
RAML.Settings.proxy = 'http://www.someproxy.com/somepath/'
Given the above, trying a GET to http://www.someapi.com/resource would get
http://www.someproxy.com/somepath/http://www.someapi.com/resource
A redirect URI for OAuth 2 can be provided in a similar manner:
RAML.Settings.oauth2RedirectUri = 'http://www.raml.org/console/'
Given the above, OAuth 2 requests would redirect back to that URL.
Add the following in a similar manner as proxying or OAuth 2.0 to ignore markdown line breaks as they are:
RAML.Settings.marked.breaks = false
In Single View mode you will be able to see only documentation or try-it.
<raml-console-loader src="path-to-raml" options="{ singleView: true }"></raml-console-loader>
Theme Switcher can be disable if needed by adding the following setting:
<raml-console-loader src="path-to-raml" options="{ disableThemeSwitcher: true }"></raml-console-loader>
Raml client generator can be disable if needed by adding the following setting:
<raml-console-loader src="path-to-raml" options="{ disableRamlClientGenerator: true }"></raml-console-loader>
Resources can be collapsed if needed by adding the following setting:
<raml-console-loader src="path-to-raml" options="{ resourcesCollapsed: true }"></raml-console-loader>
Documentation can be collapsed if needed by adding the following setting:
<raml-console-loader src="path-to-raml" options="{ documentationCollapsed: true }"></raml-console-loader>
Unsafe Markdown will be disable by default, if you want to allow unsafe content check the following example:
<raml-console-loader src="path-to-raml" options="{ allowUnsafeMarkdown: true }"></raml-console-loader>
Try-it will be enable by default, if you want to disable Try-it you can do that by adding the following setting:
<raml-console-loader src="path-to-raml" options="{ disableTryIt: true }"></raml-console-loader>
Multiple of the options above can be provided. The options need to be expressed in camelcase format:
<raml-console-loader src="path-to-raml" options="{ disableRamlClientGenerator: true, disableTryIt: true }"></raml-console-loader>
To run the console, you'll need the following:
gem install sassnpm install -g grunt-clinpm install -g bowernpm installbower install$ grunt
$ open http://localhost:9000
To run tests, you'll need the following:
gem install sassnpm install -g grunt-clinpm install -g protractornpm installnode_modules/grunt-protractor-runner/node_modules/protractor/bin/webdriver-manager update$ grunt regression
To contribute source code to this repository, please read our contributor's agreement, and then execute it by running this notebook and following the instructions: https://api-notebook.anypoint.mulesoft.com/notebooks/#380297ed0e474010ff43
FAQs
The API Console to automatically generate API documentation from RAML and OAS files.
The npm package api-console receives a total of 638 weekly downloads. As such, api-console popularity was classified as not popular.
We found that api-console demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.