OpenAPI オブジェクト
これは、 OpenAPI ドキュメントのルート オブジェクトです。
Infoオブジェクト
オブジェクトは API に関するメタデータを提供します。メタデータは、必要に応じてクライアントによって使用されてもよく、便宜上、編集またはドキュメント生成ツールで表示されてもよい(MAY)。
Contactオブジェクト
公開された API の連絡先情報。
Licenseオブジェクト
公開された API のライセンス情報。
Serverオブジェクト
サーバーを表すオブジェクト。
Componentsオブジェクト
OAS のさまざまな側面のための再利用可能なオブジェクトのセットを保持します。コンポーネント オブジェクト内で定義されたすべてのオブジェクトは、コンポーネント オブジェクトの外部のプロパティから明示的に参照されない限り、API に影響を与えません。
Pathsオブジェクト
個々のエンドポイントとその操作への相対パスを保持します。Server Object完全な URL を構築するために、パスが から URL に追加されます。アクセス制御リスト (ACL) の制約により、パスは空であっても構いません。
Path Itemオブジェクト
単一パスで実行できる操作について説明します。ACL 制約のため、パス項目は空であっても構いません。パス自体は依然としてドキュメント ビューアに公開されていますが、どの操作やパラメータが利用可能であるかはドキュメント ビューアにはわかりません。
Operationオブジェクト
パス上の単一の API オペレーションを記述します。
External Documentationオブジェクト
拡張ドキュメントの外部リソースを参照できるようにします。
Request Bodyオブジェクト
単一のリクエストボディを記述します。
Media Typeオブジェクト
各メディア タイプ オブジェクトは、そのキーによって識別されるメディア タイプのスキーマと例を提供します。
Responsesオブジェクト
操作の予期される応答のコンテナー。コンテナーは、HTTP 応答コードを予期される応答にマップします。
Callbackオブジェクト
親操作に関連する可能性のある帯域外コールバックのマップ。マップ内の各値は、API プロバイダーによって開始される可能性のある一連の要求と予期される応答を記述するパス項目オブジェクトです。パス項目オブジェクトを識別するために使用されるキー値は、実行時に評価される式であり、コールバック操作に使用する URL を識別します。
Exampleオブジェクト
固定フィールド
Linkオブジェクト
Linkオブジェクトは、応答に対する可能な設計時のリンクを表します。リンクの存在は、呼び出し元がリンクを正常に呼び出すことができることを保証するものではなく、応答と他の操作の間の既知の関係およびトラバーサル メカニズムを提供します。
Headerオブジェクト
ヘッダー オブジェクトは、パラメーター オブジェクトの構造に従いますが、次の変更があります。
Tagオブジェクト
Operation Objectによって使用される単一のタグにメタデータを追加します。操作オブジェクト インスタンスで定義されたタグごとにタグ オブジェクトを持つことは必須ではありません。
Referenceオブジェクト
OpenAPI ドキュメント内の他のコンポーネントを内部および外部から参照できるようにする単純なオブジェクトです。
Schemaオブジェクト
Schemaオブジェクトを使用すると、入力データ型と出力データ型を定義できます。これらの型はオブジェクトである場合もありますが、プリミティブや配列である場合もあります。このオブジェクトは、JSON スキーマ仕様ドラフト 2020-12のスーパーセットです。
識別子オブジェクト
リクエストの本文またはレスポンスのペイロードが多数の異なるスキーマの 1 つである場合、discriminatorオブジェクトを使用してシリアル化、逆シリアル化、および検証を支援できます。識別子は、スキーマ内の特定のオブジェクトであり、それに関連付けられた値に基づいて、ドキュメントの消費者に代替スキーマを通知するために使用されます。
XMLオブジェクト
より微調整された XML モデル定義を可能にするメタデータ オブジェクト。
Security Schemeオブジェクト
操作で使用できるセキュリティ スキームを定義します。
OAuth Flowsオブジェクト
サポートされている OAuth フローの構成を許可します。
Security Requirementオブジェクト
この操作を実行するために必要なセキュリティ スキームをリストします。各プロパティに使用される名前は、コンポーネント オブジェクトのセキュリティ スキームで宣言されたセキュリティ スキームに対応する必要があります。