The file has the following options available:
Name | Modifier | Description |
---|---|---|
metadata | optional | Sets OpenAPI metadata information for the service. |
Name | Type | Modifier | Description |
---|---|---|---|
info | object | optional | Sets main information about the service. |
server | object | array | Sets servers to be used with the API. |
Name | Type | Modifier | Description |
---|---|---|---|
title | string | required | Sets the documentation title (usually the service name). |
description | string | optional | An optional description of the API. |
version | string | required | The API version. |
Name | Type | Modifier | Description |
---|---|---|---|
url | string | required | The server URL. |
description | string | optional | An optional description of the server. |