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
a year ago

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
a year ago

You should defintely have a look at Swagger

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

2 points
antl_io's avatar
a year ago

Hey Guillaume - Anthony from Bump here. I'd be happy to get to know more about your needs, would love to connect!

1 point
What's the best video conferencing app for internal discussions?

Three major considerations I have been using to evaluate the plethora of options available: 1. Effortless/non-intrusive: It shouldn't feel like a video call 2. Price: As this app would be complime...

Confluence alternatives for wiki/knowledge bases?

I've been looking to try something new for knowledge/documentation storage for a little while now. Confluence has always been there, but I find it to be relativly limited for the cost and additiona...

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.