@becodebg/apidoc-postman
A tool to generate Postman collections from apiDoc Inline Documentation
Last updated a year ago by mminuti3 .
MPL-2.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @becodebg/apidoc-postman 
SYNC missed versions from official npm registry.

apidoc-postman

Use apiDoc to create a Postman collection.

license Build Status npm

This library uses the apidoc-core library.

How It Works

By putting apiDoc inline comments in the source code, you will get a postman.json file which can be imported into the Postman App to create a new collection.

E.g.

/**
 * @api {get} /user/id Request User information
 * @apiName GetUser
 * @apiGroup User
 * @apiPermission basic
 *
 * @apiParam {Number} id Users unique ID.
 *
 * @apiSuccess {String} firstname Firstname of the User.
 * @apiSuccess {String} lastname  Lastname of the User.
 */

Installation

npm install @panz3r/apidoc-postman

Features

apidoc-postman takes full advantage of Postman environment variables for the following aspects

API URL

Using the base_url environment variable you can specify the base URL of your APIs.

Authentication

apidoc-postman uses a simple logic to map your endpoints permissions to Postman ones.

You can set your endpoint @apiPermission to basic to have a Basic authentication on Postman, otherwise the Bearer authentication will be used by creating a reference to an environment variable called <@apiPermission>_token.

E.g. @apiPermission user maps to user_token.

N.B: At the moment only Basic and Bearer authentications are supported

Body

At the moment, apidoc-postman will setup Postman to use application/json body format.

Example

apidoc-postman -i example/ -o doc/

Have a look at apiDoc for full functionality overview and capabilities of apiDoc.

Base Postman Environment setup

{
  "base_url": "https://localhost:8000/api/v1",
  "basic_username": "basic_auth_username",
  "basic_password": "basic_auth_password",
  "user_token": "a.user.bearer.token"
}

Made with :sparkles: & :heart: by Mattia Panzeri and contributors

Current Tags

  • 2.0.1                                ...           latest (a year ago)

1 Versions

  • 2.0.1                                ...           a year ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 1
Last Month 2
Dependencies (6)
Dev Dependencies (0)
None
Dependents (0)
None

Copyright 2014 - 2017 © taobao.org |