express-jsdoc-swagger icon indicating copy to clipboard operation
express-jsdoc-swagger copied to clipboard

Swagger OpenAPI 3.x generator

Results 49 express-jsdoc-swagger issues
Sort by recently updated
recently updated
newest added

You can add a default value by using 'default:' with single value. For example: `default:ITEM_ID` ### What kind of change does this PR introduce? (check at least one) - [...

enhancement
Chore

Hi everyone! I am try to send the Authorization token for all my endpoints of my API. But the server side does not receive the header with name : "**Authorization**"...

**Is your feature request related to a problem? Please describe.** Add support for documenting callbacks, which are in OpenAPI specification v3 - https://swagger.io/docs/specification/callbacks/. Some services I'm documenting rely heavily on...

enhancement
good first issue

**Describe the bug** Currently when you use an apiKey type, which requires different parameters than the other security types (name, and in) it causes a type error. This is because...

Hello, In my application I use query params with brackets in the name. When documenting these parameters with the @param annotation it is not considered when generating the documentation (_http://localhost:8000/examples?filter[limit]=10&filter[offset]=1_)....

bug
good first issue

**Describe the bug** When I try to set an example for GET requests swagger does not generate it. **To Reproduce** ``` /** * GET /example * @summary Example * @description...

enhancement

Currently I believe if we want to specify JSON body fields of a POST/PUT request we need to create a separate object with @typedef keyword. Its would be nice to...

enhancement
good first issue

**Is your feature request related to a problem? Please describe.** Currently, specifying a security schema happens on a per-route basis with the `@security` annotation. Swagger allows specifying one security schema...

enhancement

**Describe the bug** Unable to render this definition The provided definition does not specify a valid version field. Please indicate a valid Swagger or OpenAPI version field. Supported version fields...

invalid

**Is your feature request related to a problem? Please describe.** I'm trying to add a file format to @return but there's no way to do it. **Describe the solution you'd...