Helen Kosova

Results 65 comments of Helen Kosova

@HenryGessau I think your proposed `sequence` format is already covered by the [`prefixItems`](https://json-schema.org/understanding-json-schema/reference/array#tupleValidation) keyword available in OpenAPI 3.1. Example [from here](https://stackoverflow.com/a/57465199): ```yaml # 2-element tuple; the 1st element is a...

@charjr I believe `[]` must be part of the parameter's name, other than that it's a standard exploded form-style array. Exploded form is the default style for query parameters. ```yaml...

By the way, OpenAPI 3 has built-in support for request body examples. You can provide one or multiple examples and also reference [external examples](https://swagger.io/docs/specification/adding-examples/#external). ```yaml openapi: 3.0.0 paths: /something: post:...

It's the same issue as #2030; see this comment in particular: https://github.com/swagger-api/swagger-ui/issues/2030#issuecomment-805983179

The next version of the spec, OpenAPI 3.1, will support the `style` and `explode` attributes for `multipart/form-data` that can be used to control array serialization. I.e. whether to send the...

> 9. Delete line 45 in ./src/swagger.json: "required": true, Without this line the API definition becomes invalid because, [according to the OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#user-content-parameterrequired), path parameters MUST be required.

Swagger UI expects a valid OpenAPI definition. If the API definition is invalid, correct functioning is not guaranteed. It's the responsibility of the API definition provider to make sure the...

Sorry, I missed the error in step 8 and the fact that you were using React. React applications are supposed to use the [`swagger-ui-react`](https://www.npmjs.com/package/swagger-ui-react) module instead of `swagger-ui`. Could you...

To hide the curl commands, you can add this plugin to your Swagger UI initialization code: https://github.com/swagger-api/swagger-ui/issues/5020#issuecomment-653756698

Remove `defaultModelRendering: 'model',` from your Swagger UI initialization code. That line explicitly sets the Model/Schema tab as the default one.