-
Notifications
You must be signed in to change notification settings - Fork 7
Description
Formats in the spec: https://spec.openapis.org/oas/latest.html#data-type-format
Formats registry: https://spec.openapis.org/registry/format/index.html
In the spec there are 5 defined formats in the table: int32, int64, float, double, password
But in the registry there are 10+ formats for which the source is the OAS
Also for the int64 format there is inconsistency between spec and the registry.
In the spec JSON Data Type for int64 is specified as number but in the registry it is specified as number, string. So it is not clear which type is the accurate one.
Presence of both - the Format registry and the formats table in the spec itself also leads to confusion which one is the source of truth. I would suggest 2 options which would lead to clearer understanding:
-
Delete formats table from the spec itself and reference the Formats registry as the only source of truth for the formats defined by OAS.
-
Clarify in the spec that the formats table is only a part of all formats defined by OAS and is only the example.