#openapispecification(oas)

Hey Brad so I read Swaggerize your API Documentation and I’m sold but what about protected APIs? How do I use Swagger to hit APIs which require an authentication token?

Swagger has you covered for cases where your API requires some sort of authentication token be included in the request; all you have to do is declare the authentication types your service supports and then mark each protected API…

Swagger, huh what is it good for?

Hey Brad I keep hearing people talk about how we should use swagger to document our APIs but what the heck is that?

Good question, I too was confused by what exactly Swagger was because we talk about it as an API documentation tool similar to JSDocs but when you Google Swagger it appears to be so much more than that.

Swagger is not a code document generator like JSDocs or Doxygenbut a framework…

Swaggerize your API Documentation

Hey Brad how the heck do I use Swagger to document my Node.js service APIs?

The Swagger tool which generates the documentation is a command line utility which when run will read the OpenApi Specification (OAS) description you created for your APIs and outputs HTML, CSS, and JavaScript. You can then host that generated code anywhere you wish.

One option for using Swagger to generate your API…