Can you suggest me a tool to create API documentation?

Hey, I recommend using OpenAPI specification to describe the operations of the API. Once you have the file, there are many tools to generate web pages or different things. I use them to generate frontend code (elm, typescript), backend code (java, Haskell), as well as using redoc for the API documentation page.

https://swagger.io/specification/
https://openapi-generator.tech/
https://github.com/Redocly/redoc

I can recommand Bump: https://bump.sh/

It uses standard files specifications and build for you a nice documentation + a changelog! I really like this feature that is missing from most API docs.

(This is all free, you don't need any paid tools to do this out of the box)

You want to start be generating the OpenAPI Specification. You don't need to generate this by hand (although it can be good to), most languages have a package that will generate one by annotating your services existing endpoints.

The spec is here: OpenAPI Specification

Once you have the spec available and can be served from an endpoint in your service, you can use any one of the existing UI packages to display the spec in a human readable format.

For instance using the npm package openapi-explorer will generate a fully functioning UI with all the endpoints and methods:

For Stripe feel, checkout https://github.com/slatedocs/slate

I've used these two for some projects as well as my own tool for https://docs.wobaka.com

• Slate is a great self-hosted open source option: https://github.com/slatedocs/slate
• GitBook is a nice hosted alternative: https://www.gitbook.com

Recommend both!

Swagger is good.

Swagger