Declaring only the type might be sometimes ambiguous. For example, an
UUID will typically be serialized as a string, but just declarding it as
such might be unnecessarily ambiguous for an API user.
Using the builder API, it is already possible to declare a format for
path parameters (with DataFormat()), but for structs there was no
corresponding tag so far.
Declaring only the type might be sometimes ambiguous. For example, an UUID will typically be serialized as a string, but just declarding it as such might be unnecessarily ambiguous for an API user.
Using the builder API, it is already possible to declare a format for path parameters (with
DataFormat()
), but for structs there was no corresponding tag so far.See https://swagger.io/specification/v2/#dataTypeFormat