Skip to main content

Documentation for the openapi-yaml Generator

METADATA​

PropertyValueNotes
generator nameopenapi-yamlpass this to the generate command after -g
generator stabilitySTABLE
generator typeDOCUMENTATION
generator default templating enginemustache
helpTxtCreates a static openapi.yaml file (OpenAPI spec v3).

CONFIG OPTIONS​

These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to configuration docs for more details.

OptionDescriptionValuesDefault
outputFileOutput filenameopenapi/openapi.yaml
sortOutputSort paths alphabetically, component maps (schemas, parameters, requestBodies, responses, headers, examples, links, callbacks, securitySchemes) by name, and HTTP methods in classical order (GET, PUT, POST, DELETE, OPTIONS, HEAD, PATCH, TRACE).false

IMPORT MAPPING​

Type/AliasImports

INSTANTIATION TYPES​

Type/AliasInstantiated By

LANGUAGE PRIMITIVES​

    RESERVED WORDS​

      FEATURE SET​

      Client Modification Feature​

      NameSupportedDefined By
      BasePath✗ToolingExtension
      Authorizations✗ToolingExtension
      UserAgent✗ToolingExtension
      MockServer✗ToolingExtension

      Data Type Feature​

      NameSupportedDefined By
      Custom✓OAS2,OAS3
      Int32✓OAS2,OAS3
      Int64✓OAS2,OAS3
      Float✓OAS2,OAS3
      Double✓OAS2,OAS3
      Decimal✓ToolingExtension
      String✓OAS2,OAS3
      Byte✓OAS2,OAS3
      Binary✓OAS2,OAS3
      Boolean✓OAS2,OAS3
      Date✓OAS2,OAS3
      DateTime✓OAS2,OAS3
      Password✓OAS2,OAS3
      File✓OAS2
      Uuid✓
      Array✓OAS2,OAS3
      Null✓OAS3
      AnyType✓OAS2,OAS3
      Object✓OAS2,OAS3
      Maps✓ToolingExtension
      CollectionFormat✓OAS2
      CollectionFormatMulti✓OAS2
      Enum✓OAS2,OAS3
      ArrayOfEnum✓ToolingExtension
      ArrayOfModel✓ToolingExtension
      ArrayOfCollectionOfPrimitives✓ToolingExtension
      ArrayOfCollectionOfModel✓ToolingExtension
      ArrayOfCollectionOfEnum✓ToolingExtension
      MapOfEnum✓ToolingExtension
      MapOfModel✓ToolingExtension
      MapOfCollectionOfPrimitives✓ToolingExtension
      MapOfCollectionOfModel✓ToolingExtension
      MapOfCollectionOfEnum✓ToolingExtension

      Documentation Feature​

      NameSupportedDefined By
      Readme✓ToolingExtension
      Model✓ToolingExtension
      Api✓ToolingExtension

      Global Feature​

      NameSupportedDefined By
      Host✓OAS2,OAS3
      BasePath✓OAS2,OAS3
      Info✓OAS2,OAS3
      Schemes✓OAS2,OAS3
      PartialSchemes✓OAS2,OAS3
      Consumes✓OAS2
      Produces✓OAS2
      ExternalDocumentation✓OAS2,OAS3
      Examples✓OAS2,OAS3
      XMLStructureDefinitions✓OAS2,OAS3
      MultiServer✓OAS3
      ParameterizedServer✓OAS3
      ParameterStyling✓OAS3
      Callbacks✓OAS3
      LinkObjects✓OAS3

      Parameter Feature​

      NameSupportedDefined By
      Path✓OAS2,OAS3
      Query✓OAS2,OAS3
      Header✓OAS2,OAS3
      Body✓OAS2
      FormUnencoded✓OAS2
      FormMultipart✓OAS2
      Cookie✓OAS3

      Schema Support Feature​

      NameSupportedDefined By
      Simple✓OAS2,OAS3
      Composite✓OAS2,OAS3
      Polymorphism✓OAS2,OAS3
      Union✓OAS3
      allOf✓OAS2,OAS3
      anyOf✓OAS3
      oneOf✓OAS3
      not✓OAS3

      Security Feature​

      NameSupportedDefined By
      BasicAuth✓OAS2,OAS3
      ApiKey✓OAS2,OAS3
      OpenIDConnect✓OAS3
      BearerToken✓OAS3
      OAuth2_Implicit✓OAS2,OAS3
      OAuth2_Password✓OAS2,OAS3
      OAuth2_ClientCredentials✓OAS2,OAS3
      OAuth2_AuthorizationCode✓OAS2,OAS3
      SignatureAuth✓OAS3
      AWSV4Signature✓ToolingExtension

      Wire Format Feature​

      NameSupportedDefined By
      JSON✓OAS2,OAS3
      XML✓OAS2,OAS3
      PROTOBUF✓ToolingExtension
      Custom✓OAS2,OAS3