Features

Features marked with a checkbox are supported.

Those without a checkbox aren't guaranteed to be supported.

The absence or presence of a feature here does not directly mean it will or won't be implemented, so this document also serves as a TODO list of sorts.

Platform features

  • DRY API error handling
  • DRY authentication and authorization
  • DRY pagination

OpenAPI Features

This list was built by manually scanning down the OpenAPI specification, so omissions are entirely possible.

  • Path $refs
  • Path-level consumes/produces definitions
  • Operation-level consumes/produces definitions
  • References outside a single OpenAPI file ("Relative Files With Embedded Schema")

Definitions

  • $refs in definitions
  • Model polymorphism (schema discriminator field)
  • Population of default values within models

Parameters

  • Path-level parameter definitions
  • Operation-level parameter definitions
  • Parameters in paths
  • Parameters in query string
  • Parameters in HTTP headers
  • Parameters in HTTP body
  • Primitive parameters in HTTP body
  • Parameters in HTTP form data
  • Body-type parameter schema validation
  • Parameter type/format validation
  • Parameter allowEmptyValue
  • Parameter CSV/SSV/TSV/Pipes collection formats
  • Parameter multi collection format
  • Parameter defaults
  • Parameter extended validation (maximum/...)
  • Parameter array items validation
  • Parameter Definitions Objects
  • Parameter $refs
  • Replacement of entire parameters objects with $refs

Responses

  • Operation response validation
  • Operation response $refs
  • Operation response schema validation
  • file as operation response schema type
  • Responses Definitions Objects
  • Headers validation

Security

  • Operation security declarations
  • Security Definitions Objects