Mention that we use OpenAPI 3's response code format

See comments of https://github.com/matrix-org/matrix-doc/pull/2238
This commit is contained in:
Travis Ralston 2020-05-20 18:00:27 -06:00
parent 3875d50de8
commit 1388742a52

View file

@ -43,3 +43,11 @@ doesn't work, as in the following example:
properties: properties:
... ...
``` ```
## OpenAPI 3's "2xx" format for response codes
<!-- TODO: Remove this section after upgrading to OpenAPI v3 -->
In some cases, the schema will have HTTP response code definitions like
`2xx`, `3xx`, and `4xx`. These indicate that a response code within those
ranges (`2xx` = `200` to `299`) is valid for the schema.