ponelat
StaffJoined 11 years ago
User Profile
Staff
User Widgets
Contributions
Re: Swagger offers me wrong DTO models
Hi sksskek , Could you share the OpenAPI file? And perhaps expend on: - What is the expected behaviour? Given the inputs - What is the actual output? At a guess, it looks like you have an extra/unwanted field? Take a look at the `examples` field, which can override the auto-generated JSON examples. Docs: https://swagger.io/docs/specification/adding-examples/385Views0likes0CommentsRe: How to generate Map<UUID, Integer> instead of Map<String, Integer>
Hi atumius , It looks like the format isn't applied to the inhertience (in Java at least). Could you create a ticket on https://github.com/swagger-api/swagger-codegen/issues/new with the details of how you're using codegen (via the web, via cli, via maven, etc), what language/framework and anything else that might help recreate the issue - so that the devs can take a look at it. Hope that helps!765Views0likes0CommentsRe: oneOf only validates the schema but does not add missing field with default values.
Hi SSchandrakant , Your example looks fine from a specification point of view, for the implementation specific questions (i.e., express-openapi) you'll need to reach out to that project specifically. Perhaps via GitHub. Hope that helps!381Views0likes0CommentsRe: https://developers.openapi.it/ and counter
Hi sal21 , Looks like your API requires HTTP Basic authentication. It's a base64 encoded string, made up of your username + colon (:) + password, eg: User = "josh" Password = "pa$$" String = "josh:pa$$" String after base64 encoding: "am9zaDpwYSQk" Then the full header is: "Authorization: Basic am9zaDpwYSQk" I don't know VBA, but a Google showed this snippet, which may work for you... user = "someusername" password = "somepassword" xmlhttp.setRequestHeader "Authorization", "Basic " + Base64Encode(user + ":" + password) See: https://swagger.io/docs/specification/authentication/basic-authentication/ to learn about Basic Auth.1.1KViews0likes2CommentsRe: OAS 3.1 support
Howdy folks, PM On SwaggerHub here. Looks like a public slip. We are working on OpenAPI 3.1 support, but it isn't ready for SwaggerHub just yet. This is a bug sneak preview. If you do want to see support, you can play around at https://editor-next.swagger.io, which shows the new Editor and a version of SwaggerUI with partial support (take a look at the subtle UI changes in Schema rendering as we implement JSON Schema 2020-12). Feedback is welcome! The best place is here or on GitHub issues: https://github.com/swagger-api/swagger-ui/issues424Views1like0CommentsRe: Swagger: Submitting integer in multipart/form-data?
Hi theminja , There are a few pieces here, more info is needed to see if this is a bug with any specific Swagger tool, or if this is more implementation specific. Couple of questions to help answer that. 1. What are you using in the backend? Was it generated by Swagger Codegen or other, or is it a framework? 2. How are you executing requests and where do you see the message "request/body/price must be integer". Please be specific as possible, in order for us to see how we can help. PS: The OpenAPI specification (fka Swagger) does support integers in multipart/form. So it sounds like an implementation issue or possibly a bug674Views0likes0CommentsRe: Best way to describe global client identification parameters?
Hi LukeHagar , You can add headers in two ways: - As a parameter (in: header) - As a security requirement If you're looking to have these headers across the entire API, all operations you _might_ want to use security, where you can use the root-level `security: ...` field. See https://swagger.io/docs/specification/authentication/. For bulk-adding parameters. This is a challenge to other folks too, a proposal was started to help with it called "Overlays" which is a separate document to do bulk modifications to an OpenAPI file, see: https://github.com/OAI/Overlay-Specification. The spec would allow you to say things like: "Add this parameter to every operation". Related is the idea of "traits" which is a grouping of $refs. This isn't supported by OpenAPI (today) it might be in a later version of the spec.387Views0likes0CommentsRe: How to use Swagger with WebApi-Mvc project?
Hi jdang67 , I'm no .NET expert, but the go-to library for Swagger is Swashbuckle (https://learn.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-7.0&tabs=visual-studio) . Integrating that would be a good first step, especially to see how far you can get with automated approaches. Ultimately there are two steps, getting the API details (ie: describing your API) which is what Swashbuckle helps to do. Then the second part is displaying that description (known as an OpenAPI file/definition) in some documentation tool (typically SwaggerUI, but there are others). The second step can be entirely independent of the server stack using, which is where you can manually describe the definition and then render it inside Razor pages or outside of it. Hope that helps get things going!1.3KViews0likes1Comment