-
Notifications
You must be signed in to change notification settings - Fork 9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Example request string is not populated #3233
Comments
We currently don't have support for |
@webron any idea / hints how this could be done? I could try and make a contribution. |
Thanks for the offer. Unfortunately, I can't point you in the right direction, and while @shockey can, he's really focused on finishing a different task right now. I'll assign the ticket to him so he could hopefully get back to you next week. |
Sure, that would be great! |
@kamiKAZIK, apologies for the delay in my reply. Your change to To you, and to anyone else considering implementing this feature, here's some prior art on |
@kamiKAZIK I use examples too but just the regular examples (not the "x-examples" never had a need for those) and they do work on v3.x. Take a look here: |
I am currently in the same boat of having missing x-example value display for my parameters in swagger-ui 3.x. @JsonProperty("x-example") So a swagger.json generated with swagger.jaxrs.listing.SwaggerSerializers will only have "x-example" but not "example" fields Now i am unsure why this is the case. Is "example" not a valid field for a Parameter and "x-example" is required? Am i understanding correctly that x-example support is supposed to be added to be supported by swagger-ui and the Parameter-Objects should keep their x-example Fields? |
hi @shockey, any workaround so we can get the values populated in the UI? |
@gmartinezsan Do you still have the problem? Can you send us your swagger.json? |
Hello, is this problem fixed for swagger 2.0 and swagger ui 3.25.0? I still have this problem. |
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. openapi: 3.0.0
paths:
/something:
post:
requestBody:
content:
application/json:
schema:
type: object
example: # <------
targets: [1, 2, 3, 4] |
Hey Can you assign this to me? I will try to fix the issue |
@cxx5208 this is an open source project ... you don't need anything assigned to you ... just submit a PR with your fix and add a comment referencing this issue |
What day and time are the sprint retrospectives? |
“At 20:04 on day-of-month 12.” |
Trying to migrate from swagger-ui 2x to 3.0.12. It seems that swagger-ui 3.x is not able to render x-examples data.
"/data/targets" : {
"post" : {
"tags" : [ "dummy" ],
"summary" : "Returns validation results of given list of targets.",
"description" : "",
"operationId" : "dataTargets",
"produces" : [ "application/json" ],
"parameters" : [ {
"in" : "body",
"name" : "body",
"description" : "Targets list in JSON format.",
"required" : true,
"schema" : {
"type" : "string"
},
"x-examples" : {
"default" : "{\"targets\": \"[1, 2, 3, 4]\"}"
}
}
<...>
}
In version 2.x swagger-ui was able to use the value from x-examples as example request. As a quick and dirty hack, I have made some changes in
src/core/components/param-body.jsx
updateValues = (props) => {
let { specSelectors, pathMethod, param, isExecute, consumesValue="" } = props
let parameter = specSelectors ? specSelectors.getParameter(pathMethod, param.get("name")) : {}
let isXml = /xml/i.test(consumesValue);
let paramValue = isXml ? parameter.get("value_xml") : parameter.get("value");
if (parameter.get("x-examples") && parameter.get("x-examples").get("default")) {
paramValue = parameter.get("x-examples").get("default")
}
....
}
Is it possible to address this properly? Add support of x-examples into core or maybe create a plugin for this?
The text was updated successfully, but these errors were encountered: