6.3. API プロバイダーインテグレーションの作成
API プロバイダーインテグレーションを作成するには、インテグレーションが実行できるオペレーションを定義する OpenAPI ドキュメント (.json
、9.yaml
、または .yml
ファイル) を提供します。Fuse Online は各オペレーションの実行フローを作成します。各オペレーションのフローを編集し、そのオペレーションの要件に応じてインテグレーションデータを処理するコネクションおよびステップを追加します。
前提条件
インテグレーションが実行する REST API オペレーションの OpenAPI ドキュメントを提供または定義できる必要があります。
検証するには、API プロバイダークイックスタートの OpenAPI ドキュメントである raw の
task-api.json
ファイルをダウンロード します。Fuse Online が OpenAPI ドキュメントの提供を要求したときに、このファイルをアップロードできます。この代わりに、raw のtask-api.json
ファイルである https://raw.githubusercontent.com/syndesisio/syndesis-quickstarts/1.8/api-provider/task-api.json を指定できます。- 各 OpenAPI オペレーションのフローが計画されている必要があります。
- オペレーションのフローを追加する各アプリケーションまたはサービスのコネクションが作成済みである必要があります。
手順
- Fuse Online の左ナビゲーションパネルで Integrations をクリックします。
- 右上の Create Integration をクリックします。
- Choose a connection ページで API Provider をクリックします。
Start integration with an API call ページで以下を行います。
- REST API オペレーションを定義する OpenAPI 2.0 ドキュメントがある場合は、OpenAPI ドキュメントをアップロードします。
- OpenAPI 2.0 ドキュメントを定義する必要がある場合は、Create を選択します。
Next をクリックします。
ドキュメントをアップロードした場合は、これを確認または編集します。
- Review/Edit をクリックして API Designer エディターを開きます。
- 必要に応じて確認や編集を行います。
- 右上の Save または Cancel をクリックし、エディターを閉じます。
- Next をクリックします。
ドキュメントを作成する場合は、Fuse Online で起動される API Designer エディターで以下を行います。
- OpenAPI ドキュメントを定義します。
- 右上の Save をクリックし、エディターを閉じます。
- Next をクリックします。
API エディターの使用に関する詳細は、Design and develop an API definition with API Designer を参照してください。
結果
Fuse Online は OpenAPI ドキュメントが定義するオペレーションの一覧を表示します。
次のステップ
それぞれのオペレーションでは、そのオペレーションを実行するフローを定義します。