Should OpenAPI highlight the possibility of using the data URL scheme for external examples? #4674
hudlow
started this conversation in
Enhancements
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
Originally raised here: https://github.com/OAI/OpenAPI-Specification/pull/4647/files#r2135992019
My baseline assumption is that the
data
-URL-scheme is already perfectly valid as a URI forexternalValue
in an Example Object. As far as I know we don't enumerate valid URL schemes that could be used in a URI, so there are plenty of schemes that are valid as far as OpenAPI is concerned but probably not resolvable by most tooling. (Without getting into the broader question of when you can treat a URI as a URL...)For example, I assume
ftp://example.com/foo.png
is a perfectly valid URI for anexternalValue
but not something most tools would attempt to resolve.What I'd like to resolve here is:
Something like:
Beta Was this translation helpful? Give feedback.
All reactions