Swagger (OpenAPI)

Main > Using Liquid for building your application > Set up configuration per environment > Swagger (OpenAPI)

Configure how Liquid will document the microservice's REST API according to OpenAPI standard (Swagger) as the example bellow*:

  "Swagger": {
    "ActiveVersion": "v2",
    "Versions": [
      {
        "Name": "v1",
        "Info": {
          "Description": "Proin nec augue. Quisque aliquam tempor magna. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
          "Version": "1",
          "Title": "MVP",
          "TermsOfService": "Morbi neque. Aliquam erat volutpat. Integer ultrices lobortis eros.",
          "Contact": {
            "Email": "[email protected]",
            "Name": "Smith",
            "Url": "http://foo.com/terms"
          },
          "License": {
            "Name": "Apache 2.0",
            "Url": "http://www.apache.org/licenses/LICENSE-2.0.html"
          }
        },
        "Host": "500",
        "BasePath": "/v1"
      },
      {
        "Name": "v2",
        "Info": {
          "Description": "Donec blandit feugiat ligula. Donec hendrerit, felis et imperdiet euismod, purus ipsum pretium metus, in lacinia nulla nisl eget sapien. Donec ut est in lectus consequat consequat.",
          "Version": "2",
          "Title": "FULL",
          "TermsOfService": "Morbi neque. Aliquam erat volutpat. Integer ultrices lobortis eros.",
          "Contact": {
            "Email": "[email protected]",
            "Name": "Smith",
            "Url": "http://foo.com/terms"
          },
          "License": {
            "Name": "Apache 2.0",
            "Url": "http://www.apache.org/licenses/LICENSE-2.0.html"
          }
        },
        "Host": "600",
        "BasePath": "/v2"
      }
    ]
  },

Where:

• Swagger.Versions: are declared the same way they are done in programmatic way.