1. Homepage
  2. Anypoint Code Builder

  3. API 仕様の作成

API 仕様の作成

logo cloud IDE Cloud IDE

logo desktop IDE Desktop IDE

これは進行中のベータリリースです。ベータ状態での Anypoint Code Builder の使用には、該当するベータサービス契約条件が適用されます。

Exchange へのパブリッシュや実装を行う前に Anypoint Code Builder を使用して API 仕様を作成してテストします。

  1. 新しい API 仕様プロジェクトを作成します​。

  2. 出力パネルで進行状況を追跡します​。

  3. API Console で仕様を確認します​。

  4. モッキングサービスを使用して仕様をテストします​。

Anypoint Code Builder の機能を調べるには、​oas-example​ API 仕様を使用してください。

始める前に

新しい API 仕様プロジェクトを作成する

新しい API 仕様プロジェクトを作成する手順は、次のとおりです。

  1. IDE のアクティビティバーで、​​ (​Anypoint Code Builder​) アイコンをクリックします。

    アクティビティバー内で強調表示されている [Anypoint Code Builder] アイコン

  2. [Quick Actions (クイックアクション)]​ から ​[Design an API (API を設計)]​ をクリックします。

    *「Quick Actions (クイックアクション)」* セクション内の強調表示された *「Design an API (API を設計)」* リンク

  3. [API Specification (API 仕様)]​ フォームに入力します。

    項目名 Field Value (項目値)

    Project Name (プロジェクト名)

    プロジェクトの一意の名前。

    この名前は Exchange での API 仕様のタイトルおよび仕様ファイルの名前として使用されます。 たとえば、プロジェクト名が「OAS Example」 (OAS 例) の場合、仕様ファイル名は ​oas-example​ になります。

    既存のプロジェクト名を再利用するには、その名前をすでに使用しているプロジェクトを最初に削除する必要があります。API 仕様およびフラグメントの削除を参照してください。

    Project Location (プロジェクトの場所)

    ホームディレクトリまたは作成する別のディレクトリ。

    「ホームディレクトリへのフォルダーの追加」を参照してください。

    別のプロジェクトディレクトリ内にプロジェクトを作成しないでください。

    API Specification Language (API 仕様言語)

    サポートされる OAS および RAML バージョン​を参照してください。

    この手順の​例​を使用するには、​OAS 3.0 (YAML)​ を選択してください。

    Business Group (ビジネスグループ)

    API 仕様で使用する Anypoint Platform 内のビジネスグループ。

    ビジネスグループを参照してください。

    選択したビジネスグループを API 仕様の作成後に変更することはできません。

  4. [Create Project (プロジェクトを作成)]​ をクリックします。

    プロンプトが表示されたら、フォルダー内のファイルの作成者を信頼します。

    プロジェクトの編集準備が整ったら、API プロジェクトのエディタービューで次の OAS 3.0 (YAML) 仕様のような仕様が開きます。

    新しい OAS 3.0 (YAML) API プロジェクト

  5. 引き続き API 仕様を設計します。

    要素を入力するときに、​オートコンプリート​ (Ctrl+Space) を使用すると、コンテキスト内で使用可能なオプションが表示されます。

出力パネルで進行状況を追跡する

API を設計しているときに内部処理の進行状況を追跡する手順は、次のとおりです。

  1. 出力パネルを開きます。

    手順を表示

    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+u

      • Windows: Ctrl+Shift+u

    • デスクトップ IDE で、​[View (表示)]​ > ​[Output (出力)]​ を選択する。

    • クラウド IDE で、​​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Output (出力)]​ を選択する。

  2. ドロップダウンから ​[Mule DX Server (Mule DX サーバー)]​ を選択します:

    出力ペイン内の [Mule DX Server (Mule DX サーバー)]

API Console で仕様を確認する

コンソールに仕様を表示する手順は、次のとおりです。

  1. エディターで仕様ファイルをクリックします。

  2. ​ (​API Console​) アイコンをクリックします。

  3. API Console にエンドポイントが表示されるまで待機します。

    API Console に仕様のエンドポイントが表示されます。次に例を示します。

    API Console 内の API 仕様
    1 メソッドをクリックして詳細を表示します。
    2 コンソールメニューを表示します。

  4. コンソールでメソッドをクリックするか、メニューから項目を選択して、仕様のさまざまな部分を表示します。 たとえば、​[GET]​ をクリックすると、次のように表示されます。

    Get の詳細を含む API Console

モッキングサービスを使用して API 仕様をテストする

API Console でモッキングサービスを使用して、API 仕様で設定した要求と応答を確認します。

  1. Anypoint Code Builder で API プロジェクトの仕様 (​oas-example​ など) を開きます。

  2. ​ (​API Console​) アイコンをクリックして、コンソールに仕様を表示します。

  3. API Console で GET や POST などのメソッドをクリックします。

  4. [Try It (試す)]​ をクリックします。

    API Console の [Try I (試す)] ボタン

  5. 定義したパラメーターが正しいことを確認して、​[Send (送信)]​ をクリックします。

  6. 定義した応答が API Console に返されることを検証します。次に例を示します。

    API Console での応答例

  7. 必要に応じて、モックされた API エンドポイントを照会するときに、設定済みの応答例を確認します。

OAS 3.0 (YAML) API 仕様の例

OAS 3.0 (YAML) プロジェクトを作成したら、初期仕様を次のコード例で置き換えることができます。

OAS 3.0 (YAML) API 仕様の例 
  openapi: "3.0.0"
  info:
    version: 1.0.0
    title: oas-example
  paths:
    /contacts:
      get:
        summary: Retrieve a list of contacts
        description: Returns a list of contacts.
        responses:
          '200':
            description: Successful response
            content:
              application/json:
                example:
                  - id: 1
                    firstName: John
                    lastName: Doe
                    company: Example Corp
                  - id: 2
                    firstName: Jane
                    lastName: Smith
                    company: Another Company

      post:
        summary: Create a new contact
        description: Creates a new contact.
        requestBody:
          description: Contact object to be created
          required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Contact'
        responses:
          '201':
            description: Contact created successfully
            content:
              application/json:
                example:
                  id: 3
                  firstName: John
                  lastName: Doe
                  company: Example Corp
          '400':
            description: Invalid request
          '500':
            description: Internal server error

    '/contacts/{contactId}':
      put:
        summary: Update a contact
        description: Updates an existing contact based on the contact ID.
        parameters:
          - name: contactId
            in: path
            description: ID of the contact to update
            required: true
            schema:
              type: integer
              format: int64
        requestBody:
          description: Updated contact object
          required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Contact'
        responses:
          '200':
            description: Contact updated successfully
            content:
              application/json:
                example:
                  id: 3
                  firstName: John
                  lastName: Doe
                  company: Updated Corp
          '400':
            description: Invalid request
          '404':
            description: Contact not found
          '500':
            description: Internal server error

  components:
    schemas:
      Contact:
        type: object
        properties:
          id:
            type: integer
            format: int64
          firstName:
            type: string
          lastName:
            type: string
          company:
            type: string
        required:
          - firstName
          - lastName

関連情報