Join us every Wednesday at 12pm Eastern for a live 30-minute DreamFactory webinar!

Automate Your API Documentation with Ease

API Documentation Software

An API isn't complete without companion documentation, and these days Swagger is widely considered to be the de facto API documentation format. DreamFactory will automatically create a complete set of interactive Swagger documentation alongside all generated APIs, ensuring your development team can quickly learn about the API endpoints. You'll gain several advantages from this approach:

  • The documentation is always up-to-date, ensuring your team isn't frustrated by incomplete, outdated, or nonexistent reference material.
  • Developers lacking DreamFactory administrative privileges are restricted to documentation perusal, ensuring sensitive API configurations can't be inadvertently or maliciously modified.
  • When working with remote or scripted APIs, DreamFactory allows you to import OpenAPI specifications. You can obtain these specification documents from the third-party API vendor or create them yourself using a tool such as Stoplight.

Did you know you can generate a full-featured, documented, and secure REST API in minutes using DreamFactory? Sign up for our free 14 day hosted trial to learn how! Our guided tour will show you how to create an API using an example MySQL database provided to you as part of the trial!

Create a REST API Now

Interactive API Docs for Every Data Source

Swagger documentation is interactive, meaning you can learn about the API by actually submitting API calls through the documentation interface. DreamFactory generates a list of documented API endpoints (the below screenshot presents an abbreviated list of endpoints generated for a Microsoft SQL Server database), and you can peruse the list and click on one to learn more:

Auto-generated Swagger documentation

For instance,clicking on the "Retrieve one or more records" endpoint opens up an interface that presents a list of all supported API parameters. In the case of this particular endpoint, you can identify the database fields you'd like returned, specify table joins, filter records, and limit, offset, and order results (see below screenshot).

Querying an endpoint via Swagger

After specifying any desired parameters, including the target table name, you'll be able to view the results of the API query directly within the documentation:

Reviewing Swagger results

API Documentation Powered by Swagger

Swagger is an open source tool that helps developers design, build, and document REST APIs. Created at a time when there was no standardized solution for describing REST APIs in a machine-readable manner, Swagger eloquently solved this problem in such a way that in the ensuing years companies such as Google, Microsoft, and IBM adopted it within their own products.

In 2016, the specification upon which Swagger is based was renamed to OpenAPI, however the tooling itself is still identified as Swagger.

More Resources for API Documentation

There are several useful online resources for learning more about API documentation, including:

Need API Advice?

Our team has advised thousands of companies around the world on API projects. Go to market faster by talking to the API experts.

jeanie

Ready to get started?