概要
別箇所や別ファイルの定義を指す参照で、Reference Object の $ref に URI を書く。
同一文書なら #/components/schemas/User のように JSON Pointer 断片で辿るのが典型。
相対パスや絶対 URL で外部文書も指せる。
再利用で記述を短くし、同じ型の重複定義を避けるために OpenAPI Components と組み合わせて使う。
別箇所や別ファイルの定義を指す参照で、Reference Object の $ref に URI を書く。
同一文書なら #/components/schemas/User のように JSON Pointer 断片で辿るのが典型。
相対パスや絶対 URL で外部文書も指せる。
再利用で記述を短くし、同じ型の重複定義を避けるために OpenAPI Components と組み合わせて使う。