0.4.14 • Published 4 months ago

exframe-api v0.4.14

Weekly downloads
-
License
ISC
Repository
bitbucket
Last release
4 months ago

exframe-api module

exframe-api will process the API specification with a CLI tool. exframe-api will be the layer on top of express to declare and produce the openapi.json specification files.

Features

It will produces openapi.json file from the provided schema in file routes/api.js relative to root directory.

Use

const { Api } = require('exframe-api');

Full Example

const { Api } = require('exframe-api');

const api = new Api('property-search', {
  summary: 'property search service',
  description: 'we can search properties with help of this service',
  version: '1.0',
  termsOfService: 'http://some-url',
  contactName: 'joe',
  contactUrl: 'joeswebsite.com',
  contactEmail: 'joe@joeswebsite.com',
  licenseName: 'best license',
  licenseIdentifier: 'best license',
  licenseUrl: 'license.com'
});

api.servers = [{ url: 'http://property-search' }];

require('./resource')(api);

module.exports = api;

Tests

npm run test

How to generate to openapi.json

exframe-api's cli can generate openapi.json file. You can add a script in package.json, as shown below

  "gen-spec": "node ./node_modules/exframe-api/cli.js > openapi.json"

running this command will generate openapi.json, based on the schema provided in routes/api.js. The generated file will be according to the specification provided here - https://spec.openapis.org/oas/v3.1.0

0.4.13

5 months ago

0.4.14

4 months ago

0.4.12

10 months ago

0.4.10

2 years ago

0.4.9

2 years ago

0.4.11

2 years ago

0.4.8

2 years ago

0.4.7

2 years ago

0.4.5

2 years ago

0.4.6

2 years ago

0.4.4

2 years ago

0.4.3

2 years ago

0.4.2

2 years ago

0.4.1

3 years ago

0.3.2

3 years ago

0.4.0

3 years ago

0.3.1

3 years ago

0.3.0

3 years ago

0.2.0

3 years ago

0.1.0

4 years ago