Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

API Notebook

Build Status

Interactive API notebook - demo.


# Install dependencies
npm install
npm install -g grunt-cli

# Start development server
# open http://localhost:3000

# Run tests in the browser (requires the server to be running)
open test/index.html

# Run headless tests
grunt test

Remember to add a new config file (E.g. config/development.json) to get up and running. For example, here is my development config (with secret keys omitted, you'll have to find your own set).

  "application": {
    "url": "http://localhost:3000"
  "plugins": {
    "ramlClient": {
      "oauth1": {
        "": {
          "consumerKey": "...",
          "consumerSecret": "..."
      "oauth2": {
        "": {
          "scopes": ["user", "public_repo", "repo:status", "notifications", "gist"],
          "clientId": "...",
          "clientSecret": "..."
        "": {
          "clientId": "...",
          "clientSecret": "...",
          "redirectUri": ""
    "proxy": {
      "url": "/proxy"
    "github": {
      "clientId": "...",
      "clientSecret": "..."


The project is split with multiple HTML files acting as entry points to fulfil the embedded requirement of the API Notebook. For example, src/index.html is the most feature complete page featuring all the available plugins and rendering in "page" mode, while src/embedded.html is an example of the notebook running in "embedded" mode. Finally, src/embed.html should never be opened directly but it is the rendered notebook that usually resides inside the <iframe> instance.


Project configuration is through node-config. To add or override config options, just add a file for your environment (E.g. development.json). All plugin config options should be stored under the plugins key, while other options are depicted in the example.json and default.json files.

To use the GitHub plugin functionality, register a new application on Github and set your keys in under plugins.github. Make sure that your new application has the application.url as Authorization callback URL.

You can’t perform that action at this time.