@senacor/azure-function-middleware-openapi-generator v0.0.1

OpenAPI Generator for Azure Function Middleware

This tool generates an OpenAPI definition for an Azure Function App built with the @senacor/azure-function-middleware.

Installation

npm install @senacor/azure-function-middleware-openapi-generator --save-dev

Usage

Create a configuration file openapi-generation.config.json in the project's root directory:

{
  "apiDefinitions": [
    {
      "title": "My API",
      "outputFile": "api.yaml"
    }
  ]
}

See chapter configuration for more options.

Run the OpenAPI generator with:

npx @senacor/azure-function-middleware-openapi-generator

Configuration

The configuration is stored in the file openapi-generation.config.json. Every API is described by an ApiDefinitionConfiguration object stored in the apiDefinitions array.

Parameters for ApiDefinitionConfiguration:

Logic to include / exclude http functions:

• If functionNameRegexToInclude and functionNameRegexToExclude are not specified all functions are used.
• Otherwise:
  • If the http function name matches some pattern from functionNameRegexToExclude, then the http function will be excluded from the api definition.
  • If the http function name matches some pattern from functionNameRegexToInclude, then the http function will be included into the api definition.

Supported Features

• URL path parameters
• URL query parameters if requestQueryParamsValidation is used
• Request body schema if requestBodyValidation is used
• Response body schema if responseBodyValidation is used
• Security schemas for bearer and function key authentication