Post

API client & documentation tool

Hello,

We are developing a few API internally that I would like to document.

Currently the only "documentation" available is a simple JMeter project. It contains calls to the API.

The main drawbacks are that :
* JMeter is not made to create a specification for the API
* Its XML file does not play nice on git

As I would like to version my specification / documentation in my git repository, OpenAPI seems a good fit. However, I am looking for a tool to display the documentation in a nice way (some kind of UI) and make API calls based on the specification.

Postman seems to be OK for the job but are there any other major tools that I am missing for my benchmark?

Thanks.

Mentioned
#Development
Share
Akrasiac's avatar

I’ve used Paw in the past and liked it over Postman, but it’s been a while: https://paw.cloud/
Auxl looks really interesting but I haven't tried it: https://auxl.io/

Both are available on Setapp

2 points
stefanrosenlund's avatar

You should defintely have a look at Swagger

https://swagger.io/solutions/api-documentation/

2 points
What tools do you use for personal administrative tasks?

I recently added 1Password and Backblaze to my "home stack" to coordinate thing within my family. In addition, I use: 1Password - So my wife and I can share passwords Backblaze - Automated ackups...

What are your favorite ways to use Inspect Element?

Do you open Inspect in Chrome or Inspect Element on Safari often—and if so, what are your favorite reasons to use it? Do you check how others pulled off a design, or use it to get around broken thi...

How do you manage your chat inbox?

Hey guys, first post here. As part of my work, I have to deal with and respond to a lot of incoming messages from different chats: Linkedin/WhatsApp/Signal/IG. I try to use Unreads/Archive features...

The community for power users.