Как ссылаться на себя и ссылаться на себя в развратных документах? - PullRequest
Новая
       18

Как ссылаться на себя и ссылаться на себя в развратных документах?

1 голос
/ 10 июня 2019

Если у меня есть конечная точка doc/api, которая должна указывать на текущую документацию по сваггеру, как следует выполнить самореференцию для Swagger с OpenAPI 3.0.0?

Например, учитывая 

openapi: 3.0.0
servers:
  - url: http://hello-world.com
info:
  description: |-
    Hello World!
  version: "4"
  title: Hello World

components:
  schemas:
    SwaggerDoc:
      type: object
      properties:
        address:
          $ref: '#/components/schemas/SwaggerDoc'

paths:
  /docs/api:
    get:
      summary: Swagger Documentation (HTML)
      tags:
        - Service Information
      responses:
        '200':
          description: HTML Document of RIT Translate API
          content:
            'text/html':
              schema:
                $ref: '#/components/schemas/SwaggerDoc'
        '503':
          description: The server is not ready.

И вывод из https://editor.swagger.io показывает:

enter image description here

Справа от секции ответа под Links,он показывает «Нет ссылок». Можно ли добавить ссылку на ссылку на себя по этой ссылке?

А для 503, как я должен связать ее с другой статическойстраница ошибки?

...