APIのスキーマ定義の設定

スキーマ・コンポーネントは、API 操作を呼び出す場合に実行する必要がある要求、または受け取ることが見込まれる応答に関する情報を開発者に提供する、再使用可能なスキーマを定義するものです。

このタスクについて

注: このタスクは、 OpenAPI 2.0 API 定義の構成に関連しています。 OpenAPI 3.0 API 定義の構成方法について詳しくは、 OpenAPI 3.0 API 定義の編集を参照してください。

OpenAPI ( 2.0 )で作成されたAPIには、APIのペイロード定義が記述されるセクションが含まれています。 ペイロード定義は、 OpenAPI 専用の特殊な JSON スキーマのバリエーションを用いて、API リクエストおよびレスポンスで送信されるデータの構造を記述しています。 各ペイロード定義は、想定されるデータフィールドを列挙したスキーマに対応しています。 これらのデータフィールドは、スキーマ内のプロパティとして定義され、その型、許容値、必須かどうか、およびその他の特性を記述する一連の属性を含んでいます。 利用可能な属性は数多くありますが、その大部分はあまり使われていません。

このタスクは、 API Designer UI アプリケーションを使用するか、ブラウザー・ベースの API Manager UI を使用して実行できます。

ソース 」アイコンをクリックすると、いつでも直接、基盤となる OpenAPIOpenAPI ソース・アイコンのYAMLソースに切り替えることができます。 デザインフォームに戻るには、 フォームアイコンをクリックしてください フォーム・アイコン

手順

  1. OpenAPI 2.0 API 定義の編集の説明に従って、編集のために API を開きます。
  2. 既に 1 つ以上のスキーマが定義されている場合は、 「定義」を展開します。
  3. 新規スキーマを作成することも、既存のスキーマを編集することもできます。
    • スキーマを作成するには、 「定義」 の横にある OpenAPI 2.0 API 追加アイコン 追加アイコンをクリックし、「 スキーマ定義の作成」 を参照してください。
    • 既存のスキーマを編集するには、ナビゲーションペインでスキーマコンポーネントの名前をクリックし、「 スキーマ定義の編集」 を参照してください。