Stoplight Studio is a great tool for REST API Design, modelling and documentation. I like the fact that it has a mock server built in to enable rapid testing and feedback on API design. Like most of these kind of tools out there in the market right now, it is based on the Open API … Continue reading Stoplight Studio
Dredd is really great for validating a REST API implementation against an Open API document. But it would be great if something like that existed for Async API and GraphQL specs.
Summary: This post explains what the Async API specification is, and how it is used to generate API Reference documentation for events. Introduction Async API is an API specification standard for events. It is used to define and document message driven APIs in a machine and human readable format. It is protocol agnostic, so can … Continue reading Documenting Events with Async API
Here is a list of REST API documentation solutions. Most of these tools are geared towards generating API Reference Docs from REST APIs specifications defined in OAS, RAML or API Blueprint. Most of these tools follow Slate like templates and layouts learned from the Stripe and Twilio Docs to produce their layout. Saves time and … Continue reading REST API Documentation Solutions but what about GraphQL ?