openapi-cli-tool icon indicating copy to clipboard operation
openapi-cli-tool copied to clipboard

s it possible to separate paths into separate files?

Open NeftaliAcosta opened this issue 2 years ago • 0 comments

openapi: 3.0.0
info:
  title: XXXXXXX
  version: '0.0.1'
  license:
    name: MIT
  x-complex-type:
    supported:
      - version: '2.0'
        level: baseapi
servers:
  - url: https://{environment}.demo.com
    description: Select a server
    variables:
      environment:
        enum:
          - api
          - api.dev
          - api.test
        default: api
paths:
  $ref: './groups/statusGroup.yaml'

file statusGroups.yaml

/status:
  get:
    $ref: '../endpoint/status/getVersion.yaml'

There comes a time when the swagger.yaml file has many paths and reading them is difficult. Is it possible to separate the groups/tags into separate files? I'm trying to create one file per endpoint group for easy reading but the paths: property doesn't accept $ref: in its schema. It would be great to be able to do this.

image

image

NeftaliAcosta avatar Mar 09 '22 17:03 NeftaliAcosta