実は厳密に言うとMuleSoftというのは会社名で、製品そのものを指す単語ではありません。（最初この辺が混乱する方もいると思うので補足。）

• Mulesoft: 会社名。API管理とシステム統合に特化したツールとサービスを提供する主体。
• Anypoint Platform: Mulesoftが提供する主力製品。APIの設計、構築、管理、運用を行うための統合プラットフォームです。

ここでは、最近よく耳にするMuleSoftについての基本知識を、どちらかというとエンジニア向けにザックリ説明しておきます。

MuleSoftとは？

MuleSoftは異なるシステムやアプリケーションをつなげるためのツールを提供する会社です。

その主力製品がAnypoint Platform。Anypoint Platformは企業がシステムを統合するためのAPIを管理するための製品で、この製品を利用することで様々なAPI連携で１つに繋ぎ、複雑な社内システムを一元的に管理していきましょう！というのがざっくりとした製品イメージ。

ポイント　MuleSoftの概要

• 会社名: MuleSoftはシステム統合とAPI管理に特化したツールを提供する会社。
• 現在の立ち位置: 2018年にSalesforceに買収されたものの、MuleSoftの製品は引き続き同じように提供されている。

Anypoint Platformとは？

Anypoint Platformは、簡単に説明するとインターネットを使ってアクセスできるクラウドサービスです。

Anypoint Platformには、APIの設計・開発、また管理するためのツールも含まれており、このプラットフォーム１つでAPIの開発～管理・運用までが一気通貫で可能になります。各企業や組織は自分たちのAPIを簡単に管理できるようになるため、必要なデータを効率的にやり取りすることができるようになります。例えば、顧客管理システムと在庫管理システムをAnypoint Platformを利用して連携させる、、など。

上記はざっくりとした概念図ですが、社内に複数存在するシステムをAPIを利用して「繋げる」イメージ。

すべての連携をAnypoint Platform上で実装することで、例えばシステムAとシステムB、システムBとシステムCの個別のIF（インターフェース）を定義する必要がなくなる、といった利点が生まれます。

Anypoint Platformには以下のようなコンポーネントが含まれており、これらを目的に応じて使い分けていきます。ここではあえて詳細を１個１個説明するのは避けますが、一言で言えば「APIを開発・管理するためのすべてのツール」がAnypoint Platform上に存在していることを覚えておいてください。

何はともあれ、これらを使った開発がどのように進んでいくのか？を簡単にご説明していきます。

Anypoint Platformを使った開発から運用までの流れ

実際に使ってみよう！と思った方向けに、利用イメージが何となく理解できるように、開発～運用までの一連のフェーズを簡単にメモしておきます。

1. 設計

開発の最初のステップはAPIやフローの設計から。この設計フェーズでは、Anypoint Design Centerを利用して、どのシステムやアプリケーションをつなげるかを決定します。

• 使用するツール　Anypoint Design Center
  • ここで、APIの設計とプロトタイピングを行います。APIのエンドポイントやデータ形式などを定義し、どのようにデータをやり取りするかを計画します。

2. 開発

設計が完了したら次は開発。この段階では、Anypoint Studioを利用して、実際の統合フローやAPIを作成します。

• 使用するツール　Anypoint Studio
  • Anypoint Studioを使って、統合フローを視覚的に作成。プログラムを書くことなく、ドラッグ＆ドロップでシステム間のデータ連携を設定することができます。APIの実装もここで行います。

3. テスト

開発が完了したら、テストを行います。作成したAPIや統合フローが正しく動作するかを確認します。

• 使用するツール　Anypoint Studio（テスト機能）
  • Anypoint Studioにはテストツールが組み込まれており、ローカル環境でAPIや統合フローをテストできます。これにより、問題がないか事前に確認できます。

4. デプロイ

テストが完了し、問題がなければ最後にデプロイを行います。作成したAPIや統合フローを実際の運用環境に配置します。

• 使用するツール　Anypoint Management Center
  • Anypoint Management Centerを使って、APIや統合フローをクラウド環境にデプロイします。ここで、運用に必要な設定も行います。

GitHubとの連携も可能です。ソースコードはGitHubで管理しておき、Anypoint Management Center経由でデプロイするというのが定石です。

5. 運用と管理

デプロイが完了したら、運用フェーズに入ります。APIや統合フローが正常に動作しているかを監視し、必要に応じてメンテナンスを行います。

• 使用するツール　Anypoint Management Center
  • Anypoint Management Centerを使って、運用中のAPIや統合フローのパフォーマンスを監視します。問題が発生した場合は、ここでトラブルシューティングを行います。

6. 共有と再利用

最後に、作成したAPIや統合フローを他のプロジェクトでも再利用できるように共有します。

• 使用するツール　Anypoint Exchange
  • Anypoint Exchangeを使って、作成したAPIや統合フローを共有し、他のチームやプロジェクトで再利用できるようにします。これにより、開発効率が向上します。

参考　APIとは？

このページではDesign Centerを利用してAPI仕様を定義する方法を説明します。API仕様の定義はMuleSoft開発の第１歩で、ここで説明する内容を理解すると徐々にMuleSoftの全貌が見えてくるはずです。

Design Centerでできること

ザックリいえば、APIの「型」や「外観（見た目）」を定義するためのツールです。具体的にいうと、APIのエンドポイントやメソッド、リクエストとレスポンスの構造を定義し、設計段階での動作をシミュレーションする役割を果たします。

MuleSoft Design Centerは、APIの設計、簡易テスト、管理を行うためのクラウドベースのプラットフォームです。これらの機能はAnypoint Platformの一部として提供されており、各コンポーネントがどのように連携しているかを理解することが重要です。

ポイント　Anypoint Platformの全体像

Anypoint Platformは、API管理、デザイン、開発、統合、運用を包括的にサポートするプラットフォームです。主要なコンポーネントには、Design Center、Anypoint Studio、API Manager、Runtime Managerなどがあります。

ポイント　Design Centerの動作原理

Design Centerは、主にAPI DesignerとFlow Designerの２つの主要コンポーネントで構成されており、この２つのツールを使うことでAPI仕様の定義を行うことが可能になります。

この最初の章では、Design Centerで作成できる中身・モノをご紹介していきます。

１．API Specification（API仕様）

API Specificationは、APIの構造と動作を定義する文書。これはAPIのエンドポイント、リクエストパラメータ、レスポンスフォーマット、エラーハンドリングなどを記述するもの。

• 利用するツール
  • API Designerを利用。RAML（RESTful API Modeling Language）やOAS（OpenAPI Specification）という標準的なフォーマットで記述します。
• 機能概要
  • エンドポイント定義: APIのエンドポイント（URIパス）を定義。
  • HTTPメソッド: 各エンドポイントで使用するHTTPメソッド（GET、POST、PUT、DELETEなど）を指定。
  • パラメータ: リクエストパラメータ（クエリパラメータ、ヘッダー、ボディなど）を定義。
  • レスポンス: 各エンドポイントのレスポンスフォーマットとステータスコードを記述。
  • エラーハンドリング: エラーレスポンスの定義。

サンプル　RAMLを利用したAPI仕様の例

#%RAML 1.0
title: ToDo API
version: v1
baseUri: http://api.todoapp.com/{version}
mediaType: application/json

/types:
  ToDoItem:
    type: object
    properties:
      id: integer
      title: string
      completed: boolean
    example:
      id: 1
      title: Buy groceries
      completed: false

/todos:
  get:
    description: Retrieve a list of ToDo items
    responses:
      200:
        body:
          type: array
          items: ToDoItem
          example: |
            [
              {
                "id": 1,
                "title": "Buy groceries",
                "completed": false
              },
              {
                "id": 2,
                "title": "Clean the house",
                "completed": true
              }
            ]
  post:
    description: Create a new ToDo item
    body:
      type: ToDoItem
    responses:
      201:
        body:
          type: ToDoItem
          example: |
            {
              "id": 3,
              "title": "Walk the dog",
              "completed": false
            }
  /{id}:
    get:
      description: Retrieve a specific ToDo item by ID
      responses:
        200:
          body:
            type: ToDoItem
            example: |
              {
                "id": 1,
                "title": "Buy groceries",
                "completed": false
              }
        404:
          description: ToDo item not found
    put:
      description: Update a specific ToDo item by ID
      body:
        type: ToDoItem
      responses:
        200:
          body:
            type: ToDoItem
            example: |
              {
                "id": 1,
                "title": "Buy groceries",
                "completed": true
              }
        404:
          description: ToDo item not found
    delete:
      description: Delete a specific ToDo item by ID
      responses:
        204:
          description: ToDo item successfully deleted
        404:
          description: ToDo item not found

RAMLが読めなくても大体何をしているかは理解できるかと思います。→APIの見た目（リクエストの型・レスポンスの型を定義しています。）

この型をもとに、後続のステップで実際にAPIの実装（データ連携などのビジネスロジック）をしていく流れになります。API Specificationは「APIを利用する人向け」に「どんなAPIなのか？」を説明するためのものでもあると考えることができます。

２．Flow（フロー）

Flowは異なるシステムやサービス間のデータフローやプロセスを定義するもの。Flow Designerを使用して、ドラッグアンドドロップで簡単に設計することができます。ただし、Flow Designerは複雑なロジックを実装することは難しく、実際にはAnypoint Studioを利用することが一般的です。

• 利用するツール
  • Flow Designerを使用。視覚的なインターフェースを提供し、ローコードで統合フローを設計します。
• 機能概要
  • コネクタ: 各種システムやサービス（Salesforce、Database、HTTPなど）との接続を設定。
  • プロセス定義: データの流れや処理手順を定義。
  • トリガー: フローを開始するトリガーイベント（タイマー、HTTPリクエストなど）を設定。
  • データ変換: DataWeaveを使用してデータのマッピングや変換を行います。
  • 条件分岐: データや条件に応じてフローを分岐させるロジックを設定。

３．モックサーバー

モックサーバーは、実際のバックエンドがなくてもAPIの動作をシミュレートするためのものです。API仕様に基づいて自動的に生成されます。（関連　モックとは？）

• 利用するツール
  • API Designerから生成。設計したAPI仕様に基づいて、リアルタイムでモックサーバーを立ち上げ、APIの動作を確認することが可能。
• 機能概要
  • リクエストシミュレーション: クライアント側からのリクエストをシミュレートし、定義されたレスポンスを返します。
  • エラーレスポンス: エラーレスポンスのテストも可能です。
  • 即時フィードバック: モックサーバーを使用して、設計中にAPIの動作を確認し、必要な修正をリアルタイムで行います。

補足：Design Centerでの作業と流れ

1. API Specificationの作成（Design Center）

• API Designerを使用して、APIのエンドポイント、HTTPメソッド、リクエスト/レスポンスの構造などをRAMLまたはOASで定義します。
• この段階では、APIの「型」としての仕様書が作成されるのみ。

2. APIの実装（Anypoint Studio）

• Design Centerで作成したRAML/OAS仕様書をAnypoint Studioにインポートします。
• Anypoint Studioで、APIの実際のビジネスロジック、データ処理、バックエンドサービスとの連携などを実装します。
• 具体的には、Muleフローを構築し、必要なコネクタやトランスフォーマーを設定します。

3. デプロイと実行（Anypoint Platform）

• Anypoint Studioで完成したAPI実装をAnypoint Platformにデプロイします。
• デプロイされたAPIは、Anypoint Runtime Managerを通じて管理、監視、スケーリングされます。
• これにより、実際のAPIがエンタープライズ環境で動作し、クライアントからのリクエストに応答します。

まとめると以下のような流れです。

1. Design CenterでAPIの「型」を定義（API仕様書の作成）。
2. Anypoint Studioでその「型」に基づいてAPIの実装を行う。
3. Anypoint Platform上で実装されたAPIをデプロイし、運用・管理する。