Skip to content

v3.2: Formats Registry: Inconsistent with the formats in the spec #39

@valerii15298

Description

@valerii15298

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:

  1. Delete formats table from the spec itself and reference the Formats registry as the only source of truth for the formats defined by OAS.

  2. Clarify in the spec that the formats table is only a part of all formats defined by OAS and is only the example.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions