The Best API Documentation Tools for Dev Teams in 2023

This page summarizes the projects mentioned and recommended in the original post on dev.to

Our great sponsors
  • SurveyJS - Open-Source JSON Form Builder to Create Dynamic Forms Right in Your App
  • WorkOS - The modern identity platform for B2B SaaS
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • redoc

    📘 OpenAPI/Swagger-generated API Reference Documentation

  • ReDoc is a tool that's similar to Swagger UI. It also takes an OAS and renders an interactive HTML page with full API documentation details; however, it has a notable difference.

  • Newman

    Newman is a command-line collection runner for Postman

  • Postman is an API platform for designing and building APIs. Postman's API Documentation Tool helps you generate, edit, and publish your docs. Since Postman has one of the largest developer communities out there, it makes sense to choose Postman's API Documentation Tool if you're already integrated within their ecosystem.

  • SurveyJS

    Open-Source JSON Form Builder to Create Dynamic Forms Right in Your App. With SurveyJS form UI libraries, you can build and style forms in a fully-integrated drag & drop form builder, render them in your JS app, and store form submission data in any backend, inc. PHP, ASP.NET Core, and Node.js.

    SurveyJS logo
  • swagger-ui

    Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.

  • Swagger is a set of open source tools that help you design and build an API, which you define using an OpenAPI Specification (OAS). In particular, Swagger UI is a tool that takes your OAS and automatically generates documentation for your API in an interactive HTML page.

  • github-action

    GitHub action to deploy your API documentation on Bump (by bump-sh)

  • Bump.sh is a tool that's swiftly gaining popularity as it combines many of the best features from the previous five entries in this roundup.

  • apiDoc

    RESTful web API Documentation Generator.

  • Compared to the first three tools, apiDoc takes a different approach towards generating documentation. Rather than rely on an API definition file like OAS, apiDoc is a package that allows you to add documentation directly into your source code through annotations. While there are third-party libraries that can create OAS files based on code annotations, having this built-in makes apiDoc slightly better if you want to control documentation through code instead of having a separate tool.

  • WorkOS

    The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

    WorkOS logo
NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts