Display static documentation information for multipart properties in OpenAPI 3.0 files

[RichieLoco]

Following on from #5164, I am suggesting that for specs with multipart/form-data that we allow the main request body of the spec to show a preview of the payload, rather than leaving it blank (and appearing unrendered) like so:

For "Try it now" feature it appears rendered correctly:

I am proposing something similar to the above pic, even if text areas/drop-downs appear greyed out. Attached following spec as an example which highlights what I thought was an issue, but turns out to be a feature:
v3.20.2_multipart_snippet.txt
Cheers, Rich

[hkosova]

Possibly related (or duplicate): #4581

[shockey]

@hkosova very closely related indeed, but this is for multipart/form-data properties, which display like parameters but are not parameters 😄

[mariaefi29]

Hi all! Do you have any updates on that issue?

[andreaszehender]

Any updates? That's a bad limitation currently.

[KhushbooBaheti]

any updates on this?

[Simon-Gregory-LG]

Somewhere between 3.32.5 and 3.42.0 it doesn't even display any json in the try it now textbox any more.

Multipart support seems to be lagging behind the standard quite a bit now.

Multipart is extremely useful for sending object data + file data, which is actually a fairly common scenario. This actually worked better back in 3.16.0 with the v2 spec.

Is there a roadmap to improve the multipart experience?

[ypark9]

Any updates??

[osteel]

Need this too!

[jalagari]

Is there any workaround or other way as its looks very bad experience

[osteel]

@jalagari at the moment I provide a sample JSON in the endpoint's description directly

[JMPSequeira]

Are there plans to make this happen?

[emmanuelmathot]

Any updates on this?

[charalarg]

Hello everyone, i made a quick fix for this issue, regarding documentation of the multipart/form properties, on my fork. https://github.com/charalarg/swagger-ui. You can see the result on the readme file.

[hassanemad15697]

Hello everyone, any updates on this issue?

[boukenka]

Hello. Any update on this?

[Davidos533]

Hello, it's really needed

Else i need go to bottom of swagger page and see schema in schema repository there.

[originalmk]

Still needed, so +1

[kenchen-cs]

I have a simple change that can help on this.

#9756 (comment)

[jearton]

neet it + 1

[peter-pundy-actabl]

Would still like to see this implemented. +1