apidoc-plugin-example
v0.2.0
Published
Examples Plugin for apidoc.
Downloads
132
Maintainers
Readme
apidoc-plugin-example
Generates and inject apidoc example elements from api schemas or files.
@apiExample {SCHEMA_TYPE=PATH_TO_SCHEMA} ELEMENT_TYPE TITLE
Install
npm install apidoc-plugin-example --save-dev
Supported Schema Types
json
Prettifies JSON and injects in.
jsonschema
Uses json-schema-faker to generate a sample response.
Example Use
/**
* @api {get} /api GetAPI
* @apiExample {json=./ex/api.req.json} apiParamExample Request
* @apiExample {jsonschema=./ex/api.res.json} apiSuccessExample Response JSON
* @apiExample {xml=./ex/api.res.xml} apiSuccessExample Response XML
*/
Developer Note
This plugin uses parser-find-elements
@ priority 201
.
TODO
- Add in wsdl schema / XSD