Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Creating html doc from postman collection [closed]

I've developed a pretty extense API, and I have it on Postman, which works pretty nice. Now I have to generate an html doc to keep it versioned inside /docs along with my sources.

Is there a tool or a way to achieve this? I really don't want to write all this documentation. Sharing the postman collection is not an option.

like image 544
danielrvt Avatar asked Mar 24 '15 16:03

danielrvt


People also ask

How do you create a document from the Postman collection?

To create documentation, click Documentation and enter the request URLs with the methods you want to document. Click Next to enter the name for the APIs and a general description for your API. Postman creates a collection and generates documentation that you and your team can view.

Can we download Postman documentation?

As of now there is no way to extract the documentation as a PDF file and send it as an attachment.

Are Postman collections private?

By default, documentation for a collection or API is private. You can view the documentation for any collections or APIs that have been shared with you directly or through a team workspace. Documentation authors can also choose to publish their documentation to make it publicly available.


1 Answers

I recently had the same problem and I did not find anything. So I created a simple tool to do it. It is a very basic javascript application written with react.js. At the moment it is very basic, but I'm working on it, so any feature request is welcome.

You can use it for free at: http://www.vernizzis.it/docman/

Plus you can get the code and modify it at: https://github.com/davidevernizzi/docman

Any comment is more than welcome.

UPDATE1: looking around I also found this project: https://github.com/JakeWorrell/docodile and this feature request: https://github.com/a85/POSTMan-Chrome-Extension/issues/204

UPDATE2: the feature request (see UPDATE1) has been closed and the possibility of creating documentation has been added to Postman cloud. Here is the feature request closing comment:

This is available as part of Postman Cloud: http://blog.getpostman.com/2015/12/10/introducing-postman-cloud/. Cloud hosts, updates and maintains documentation for everyone. I'd suggest http://docman.launchrock.com/ and https://github.com/JakeWorrell/docodile for generating one-time documentation from Collections.

like image 122
Davide Vernizzi Avatar answered Oct 30 '22 12:10

Davide Vernizzi