そのようなファイルには明示的な仕様属性は含まれていませんが、近くにあるプライマリ仕様ファイルから参照されます。
次の例では、同じディレクトリに存在する 2 つのファイルがあります。 1 つ目のファイルは単純なプライマリ仕様ファイルです。 2 つ目は最初のファイルから参照されているため、同様に仕様と見なすことが提案されます。
プライマリ仕様ファイル openapi.yaml:
openapi: 3.1.0
components:
schemas:
CustomSchema:
description: Custom schema object
properties:
foo:
$ref: 'common.components.yaml#/components/schemas/CommonSchema'
仕様ファイル候補 common.components.yaml:
components: # 'Mark file as OpenAPI specification' highlighting
schemas:
CommonSchema:
description: Common schema object reused in several specifications