У меня есть следующее определение OpenAPI YAML. Раздел externalDocs
находится под разделом servers
, но отображается перед сервером в предварительном просмотре в редакторе Swagger (https://editor.swagger.io/). Почему это?
openapi: 3.0.0
info:
title: Service
description: >-
Service description
version: '1.0'
termsOfService: >-
https://pdf/API_Developer_Agreement.pdf
contact:
email: '[email protected]'
name: 'contact Europa'
servers:
- url: http://api.example.com/v1
description: Optional server description, e.g. Main (production) server
- url: http://staging-api.example.com
description: Optional server description, e.g. Internal staging server for testing
externalDocs:
description: "externalDocs"
url: 'https://externalDocs'
paths:
/users:
get:
summary: Returns a list of users.
description: Optional extended description in CommonMark or HTML
responses:
'200':
description: A JSON array of user names
content:
application/json:
schema:
type: array
items:
type: string