schema-format-deprecated

Since 0.10.0 · In the rulesets: Recommended at warning, Strict at warning, All at warning

This rule reports the formats which the OpenAPI format registry marks as deprecated from OpenAPI 3.1, and names what replaces them.

Rule details

Format Use instead
byte contentEncoding: base64
base64url contentEncoding: base64url
binary contentMediaType, or the media type of the body or part without a schema

AsyncAPI schemas are a superset of JSON Schema draft 7, which has contentEncoding and contentMediaType, so the issues are warnings in AsyncAPI 2.x and 3.x documents. See Formats for every format.

Turn the rule off when the documents must stay readable by tools that only know the older formats.

Examples

Good.

asyncapi: 3.0.0
components:
  schemas:
    Avatar:
      type: string
      contentEncoding: base64

Bad.

asyncapi: 3.0.0
components:
  schemas:
    Avatar:
      type: string
      format: byte

Turn it off or change its severity

In apigenie.yaml, off turns the rule off and warning or error sets its severity; a rule with options takes the severity and the options as a pair, [warning, options]. lint.asyncapi has the details.

commands:
  lint:
    asyncapi:
      rules:
        schema-format-deprecated: off

Related rules

Further reading

Was this helpful?