openapi-generator/samples/yaml/api-docs.yml

apiVersion: 1.0.0
swaggerVersion: "1.2"
apis: 
  - path: /pet
    description: Operations about pets
  - path: /store
    description: Operations about store
  - path: /user
    description: Operations about user
authorizations: 
  oauth2: 
    type: oauth2
    scopes: 
      - PUBLIC
    grantTypes: 
      implicit: 
        loginEndpoint: 
          url: "http://localhost:8002/oauth/dialog"
        tokenName: access_code
      authorization_code: 
        tokenRequestEndpoint: 
          url: "http://localhost:8002/oauth/requestToken"
          clientIdName: client_id
          clientSecretName: client_secret
        tokenEndpoint: 
          url: "http://localhost:8002/oauth/token"
          tokenName: access_code
  apiKey: 
    type: apiKey
    passAs: header
info: 
  title: Swagger Sample App
  description: "This is a sample server Petstore server.  You can find out more about Swagger \n    at <a href=\"http://swagger.wordnik.com\">http://swagger.wordnik.com</a> or on irc.freenode.net, #swagger."
  termsOfServiceUrl: "http://swagger.io/terms/"
  contact: "apiteam@swagger.io"
  license: Apache 2.0
  licenseUrl: "http://www.apache.org/licenses/LICENSE-2.0.html"