Interactive documentation for your API
We utilize OpenAPI (formerly Swagger) to generate both static documentation and an interactive API console
If you use another type of API specification, such as RAML, WADL, or API Blueprint, you can use api-spec-converter to generate an OpenAPI document.
You can see the console in action for over 250 different APIs at AnyAPI.
You can also see the Hacker News example contained in this repository.
Simply clone this repository, and replace swagger.json
with your Swagger file. You can then
serve the site statically using Apache, NodeJS, or whatever else.
To change the title of the console, edit styles.css
.
If you work on the gh-pages
branch of your fork, you should be able to see it running at
https://your-username.github.io/lucy-console
You can also add additional styles or by editing styles.css
, or replacing minified/css/bootstrap.css
with a custom Bootstrap theme.
You can serve these assets for several different APIs by introducing a server-side component, e.g. NodeJS with Express:
var path = require('path');
var express = require('express');
var app = express();
app.get('/:api_name/swagger.json', function(req, res) {
res.json(require('./specs/' + req.params.api_name + '_swagger.json'));
});
app.use('/:api_name', express.static(__dirname));
A commercial version of the LucyBot console is also available for a one-time licensing fee.
Additional features include:
- Sample code generation
- Recipes (step-by-step tutorials for complex workflows)
- Embeddable UI components
- Simple customization and branding
- Custom authentication schemes
- API galleries and discovery
- Support via phone and e-mail
Please contact sales@lucybot.com for more information
We've decided to merge this open-source project with our commercial product in order to reduce code duplication. The assets in this repository are auto-generated from the upstream commercial repository.
v1 will continue to exist on the master branch, and we will continue responding to bugs and pull requests. However, all active development will take place in the commercial repository, with some features propagating down into this branch.
We encourage all existing users to migrate to the static-site
branch or consider
purchasing a commercial license.
The files in this repository are entirely auto-generated, with the exceptions of
swagger.json
and styles.css
. If you'd like to contribute, let us know and we'll
add you to the upstream repository.