Support RFC 9457 when describing error responses

[milkshakeuk]

Hi, have you considered implementing the RFC9457 standard into the openapi schema for error responses? there is a blog post talking about adopting this over on the swagger website.

currenty the schema for errors is just

    exception:
      type: object
      description: |-
        Information about the exception: an error code plus an optional description.
      required:
        - code
      properties:
        code:
          type: string
        description:
          type: string

i.e.

{
  "code": "string",
  "description": "string"
}

which I think could be improved by adopting RFC9457

[cportele]

Meeting 2025-09-08: We will recommend it in v1.1 from Part 1. Common currently recommends the predecessor RFC (7807).

[milkshakeuk]

@cportele It's worth noting this RFC is meant to cover http status code ranges 4XX and 5XX.

It might have been obvious but just wanted to highlight that.