Api Documentation tools

Slate

With Slate, the description of your API is on the left side of your documentation, and all the code examples are on the right side. Inspired by Stripe’s and Paypal’s API docs. Slate is responsive, so it looks great on tablets, phones, and even in print. If your API has bindings in multiple programming languages, you can easily put in tabs to switch between them. In your document, you’ll distinguish different languages by specifying the language name at the top of each code block, just like with Github Flavored Markdown.

Slate

Tool Description as in https://github.com/lord/slate

Image Credit: https://github.com/lord/slate

download-Slate

apiDoc

Inline Documentation for RESTful web APIs. Integrated is an API history, with that various API version levels can be compared. So it can be retraced what changed in the API since the last version.

apiDoc

Tool Description as in http://apidocjs.com/

Image Credit: http://apidocjs.com/

download-apiDoc

FlatDoc

Flatdoc is a small JavaScript file that fetches Markdown files and renders them as full pages. Essentially, it’s the easiest way to make open source documentation from Readme files. Create a file based on the template, which has a bare DOM, link to the scripts, and a link to a theme. It will look something like this (not exact). For GitHub projects, simply place this file in your GitHub pages branch and you’re all good to go.

FlatDoc

Tool Description as in http://ricostacruz.com/flatdoc/

Image Credit: http://www.cssreflex.com/documentation-tools/

download-FlatDoc

API Blueprint

API Blueprint is simple and accessible to everybody involved in the API lifecycle. Its syntax is concise yet expressive. With API Blueprint you can quickly design and prototype APIs to be created or document and test already deployed mission-critical APIs.

API-Blueprint

Tool Description as in https://apiblueprint.org/

Image Credit: https://atom.io/packages/api-blueprint-preview

download-API-Blueprint

Swagger

Swagger is a powerful open source framework backed by a large ecosystem of tools that helps you design, build, document, and consume your RESTful APIs. Design new APIs, or edit existing ones, in a powerful Editor which visually renders your Swagger definition with concise, real time feedback and error handling.

Swagger

Tool Description as in http://swagger.io/

Image Credit: http://swagger.io/

download-Swagger

Miredot

Miredot generates your documentation with each build so it is guaranteed to correspond to the implementation at all times. We only need your existing Java source code.

Miredot

Tool Description as in http://www.miredot.com/

Image Credit: http://www.miredot.com/

download-Miredot

RAML

RESTful API Modeling Language (RAML) makes it easy to manage the whole API lifecycle from design to sharing. It’s concise – you only write what you need to define – and reusable. It is machine readable API design that is actually human friendly. RAML lets you see what your API looks like as you design it, using easy to read plain text. Without having to write a single line of code you can not only perfect your API design, but also create a fully functional mock for customers, partners, or even your own internal engineers to review and build off of.

RAML

Tool Description as in http://raml.org/

Image Credit: http://raml.org/

download-RAML

RestDoc

Spring REST Docs helps you to document RESTful services. It combines hand-written documentation written with Asciidoctor and auto-generated snippets produced with Spring MVC Test. This approach frees you from the limitations imposed by tools like Swagger. It helps you to produce documentation that is accurate, concise, and well-structured. This documentation then allows your users to get the information they need with a minimum of fuss.

RestDoc

Tool Description as in https://projects.spring.io/spring-restdocs/

Image Credit: http://www.slideshare.net/EricAhn/spring-restdoc201511

download-RestDoc

Gelato

Gelato removes all the hassle of creating and maintaining technical docs, and makes onboarding developers easy. Gelato doesn’t just give you amazing docs. You also get a full-featured developer portal. Define your API and we’ll generate sample code in every language you need.

Gelato

Tool Description as in https://gelato.io/

Image Credit: https://gelato.io/

download-Gelato

Kong

The open-source API gateway and microservices management layer, delivering high performance and reliability. Built on top of NGINX, Kong can be fully operated with a simple and easy to use RESTful API. Put your services behind Kong and add powerful functionality through Kong Plugins, in one command.

Kong

Tool Description as in https://getkong.org/

Image Credit: https://getkong.org/

download-Kong

Useful Videos

RAML

Source:Lee Cooper

Swagger

Source:Dominik Marczuk

apiDoc

Source:The Skater Dev

Leave a Reply

Your email address will not be published. Required fields are marked *