Avantation
avantation is a tool to generate an OpenAPI 3.0 specification from HTTP Archive format(HAR).
avantation is written and maintained by Anbarasan K (anbuksv@gmail.com).
- Project home page: https://www.avantation.in/
- Code home page: https://github.com/anbuksv/avantation
- Issue tracker: https://github.com/anbuksv/avantation/issues
Contributing
Bug reports and code and documentation patches are welcome.
Install
Direct downloads are available through the release page.
If you have Node installed on your computer just run npm install
npm install -g avantation
Features
- HTTP sample code generation
- Dynamic route path conversion
- Schema generation
- Supports json/yaml output formats
- JWT authentication header mapping
- Static-UI generation
Usage
Build OpenAPI specification from HAR.
USAGE
$ avantation HAR
ARGUMENTS
HAR http archive(har) path
OPTIONS
-b, --base-path=base-path Separate the common path as base path from HTTP requests.
Example:['api/v1']
-h, --host=host Filter the http request from HAR and use it as server url in output.
-j, --json Write output result in JSON format.
-o, --out=out [default: ./openapi.yaml] Write output result at this DEST location.
-r, --path-param-regex=path-param-regex [default: ^([0-9]|[-$@!~%^*()_+])+$] Convert Regex matching params into dynamic path
-s, --security-headers=security-headers [default: {}] Map matching HTTP headers into security headers on request.
-t, --template=template To override the default template pass the your template file location.
--disable-tag Diable end points grouping based on route path in HAR
--http-snippet Generate HTTP smaple code snippet for request and append it as 'x-code-sample' to OpenAPI path
object.
Demo
Existing Projects
Tools : Firefox | Chrome | Safari | Charles Proxy
New Projects
Tools : Insomnia
User Interface's
FAQ
How to generate Static-UI?
avantation-ui bash script will help you to build static user interface for your specs but it's required redoc-cli.