Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

s it possible to separate paths into separate files? #24

Open
NeftaliAcosta opened this issue Mar 9, 2022 · 0 comments
Open

s it possible to separate paths into separate files? #24

NeftaliAcosta opened this issue Mar 9, 2022 · 0 comments

Comments

@NeftaliAcosta
Copy link

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

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant