@studiohyperdrive/api-docs

Studio Hyperdrive API docs npm package

Usage no npm install needed!

<script type="module">
  import studiohyperdriveApiDocs from 'https://cdn.skypack.dev/@studiohyperdrive/api-docs';
</script>

README

Node.js API Docs

Simple Node.js package which exposes Swagger docs both in JSON and HTML.

Installation

$ npm install -S @studiohyperdrive/api-docs

Setup

app.use(docs({
    name: "my-api",
    version: "1.0.0",
    baseUrl: "/",
    path: "path/to/docs/folder/",
    basePath: "/v1",
    host: "studiohyperdrive.be",
    schemes: ["https", "http"],
    NODE_ENV: [
        "development"
    ]
}));

Configuration

  • name
    • Name of the API.
    • Defaults to the package.json name.
  • description
    • Description of the API.
    • Defaults to the package.json description.
  • version
    • Version of the API.
    • Defaults to the package.json version.
  • baseUrl
    • All routes will be prefixed with this value.
    • Defaults to "/".
  • path
    • Path (starting from the root) where all the docs can be found.
    • Package will search for Swagger docs in folder and nested folders.
  • NODE_ENV
    • Package exposes two routes only in specific NODE_ENV's.
  • host
    • host is the domain name or IP address (IPv4) of the host that serves the API.
    • Empty by default.
  • basePath
    • basePath is the URL prefix for all API paths, relative to the host root. It must start with a leading slash /.
    • Defaults to "/".
  • schemes
    • schemes are the transfer protocols used by the API. Swagger supports the http, https, and WebSocket schemes – ws and wss.
    • Defaults to "https".

Usage

Swagger docs will be available on these routes:

(Replace https://my-own-url.com with your domain. baseUrl is optional depending on your config.)