Revamped HTTP docs on API Portal ππ
The fight for improving the Developer Experience in API portals is not over yet!
In fact, we have just released a major revamp of HTTP documentation to all our customers. π
Letβs see the new features in details.
π¨βπ» New Curl Examples
Our HTTP docs now show API console with Curl commands for each endpoint.
What is Curl, you say?
It is a nifty tool for making HTTP calls from the terminal, popular with developers. Curl can be installed on Linux, MacOS and Windows.
Hereβs what a simple Curl command looks like:
Whatβs in our Curl Examples?
Our API portal uses examples from the API description file to create Curl commands which are then shown in the endpoint documentation.
Checkout how the Curl command contains all the right headers; it even caters for API authentication and the body format of the request.
In fact, the Curl examples fully integrate with the API Console letting the user change the endpoint parameters while those changes are reflected in the example live.
The user can just copy and paste the Curl command in their favorite terminal to run it.
π Improved Authentication docs
Our Authentication section now shows detailed docs for common authentication types such as HTTP basic, OAuth 2 and custom API keys.
These docs include Curl examples so that the users can try them out in the terminal. Check out this example for an API that uses OAuth 2 Client Credentials grant:
All of this is auto-generated from the API description file!
βοΈ Can your Portal do this?
Our API portals have:
- API console with Reactive Code Samples
- Language-specific documentation (for 10 languages)
- Lots of other goodies :)
Give our portal generator a try!