Intro to API documentationPostman’s API documentation feature allows you to share public or private API documentation, beautifully viewable via a web page.
Postman generates and hosts browser-based API documentation for your collections automatically in real-time. Each collection has a private and public documentation view, generated in real-time using the data synced to our servers. In order to access the private view, click “View in web” in the Postman app or in the “Team Library”. The public view is accessible via the public link, generated when you publish your documentation. This link will be displayed right after your documentation is published, and is also accessible via the “Published” dropdown in the private documentation view.
What gets automatically generated?Documentation for your API includes the following:
- Sample requests, and parameter tables, headers, and other metadata
- Descriptions associated with requests, folders, and collections
- Generated code snippets in some of the most popular programming languages
Documentation is organized into sections that reflect the structure of your collection, by ordered requests and folders. Descriptions can be customized using Markdown styling with embedded graphics to complement your documentation. GitHub flavored markdown is also supported, so you can even include tables. When including block elements, ensure that you leave an empty line before and after to avoid any rendering issues.
Download the version for MacOS, Windows or Linux at https://www.getpostman.com/postman
The Google Chrome browser extension is here https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbncdddomop