API コネクタを開発する (Microsoft Flow)Develop an API connector (Microsoft Flow)

コネクタを作成するには複数の手順があります。Building a connector involves multiple steps. 最初に、Microsoft Flow でページの右上にある [設定] ボタン (歯車アイコン) をクリックまたはタップします。To get started - in Microsoft Flow, click or tap the Settings button (the gear icon) at the upper right of the page. 次に、[Custom Connectors (カスタム コネクタ)] をクリックまたはタップします。Then click or tap Custom Connectors.

API コネクタの検索

API を記述するDescribe your API

API コネクタを記述するには、HTTP API のインターフェイスを定義するための OpenAPI 標準を使います。API connectors are described using the OpenAPI standard for defining the interface of an HTTP API. 既存の OpenAPI ファイルを使って作成を始めることも、OpenAPI ファイルを自動的に生成する Postman Collection をインポートすることもできます。You can start building with an existing OpenAPI file, or you can import a Postman Collection, which auto-generates the OpenAPI file for you.

API の定義の図

いずれかの API 記述で始めた場合、ウィザードのメタデータ フィールドは自動的に設定されます。If you start from either of these API descriptions, the metadata fields in the wizard are auto-populated. これらはいつでも編集できます。You can edit these at any time.

セキュリティを構築するBuild security

サービスでサポートされる認証の種類を選択し、追加の詳細を指定して、サービスとクライアントの間を ID が適切に流れるようにします。Pick the authentication type supported by your service, and provide additional details to enable identity to flow appropriately between your service and any clients.

セキュリティの図

コネクタのセキュリティについて詳しくはこちらをご覧ください。Learn more about the connector security.

トリガーとアクションを作成するBuild triggers and actions

  1. コネクタのトリガーとアクションを作成するには、[定義] タブに切り替えます。To build the triggers and actions for your connector, switch to the Definition tab.

    定義の図

  2. ウィザードでは、新しい操作を追加したり、既存の操作のスキーマや応答を編集したりできます。Using the wizard, you can add new operations or edit the schema and response for existing ones. 各操作の [全般] プロパティでは、コネクタのエンド ユーザー エクスペリエンスを制御できます。The General properties for each operation enable you to control the end-user experience for your connector. 各操作の種類について詳しくは、次のリンクをご覧ください。Learn more about the different types of operations using the links below:

  3. 最後に、[Create connector (コネクタの作成)] をクリックまたはタップして、API コネクタを登録します。Finally, click or tap Create connector to register the API connector.

ウィザードでは使用できない追加機能については、condevhelp@microsoft.com にお問い合わせください。For additional features not available in the wizard, please contact condevhelp@microsoft.com.

コネクタをテストするTest the connector

提出する前に、以下の 1 つまたは複数の方法で API コネクタをテストします。Prior to submission, test your API connector in one or more ways:

  • API コネクタのテスト ウィザードを使います。各操作を呼び出して、機能と応答スキーマを確認できます。Using the API connector Testing wizard, you can call each operation to verify its functionality and the response schema.
  • Microsoft Flow のデザイナーでは、API コネクタを使ってフローを視覚的に構築できます。In the designer for Microsoft Flow, you can visually build flows using your API connector. このテスト方法では、ユーザー インターフェイスの機能とコネクタの機能を確認できます。This method of testing gives you visibility into the user interface functionality and features of your connector.
  • PowerApps Studio では、数式バーを使って各操作を呼び出し、画面上のコントロールに応答をバインドできます。In the PowerApps Studio, you can call each operation using the formula bar, and bind the response to controls on your screen.

このトピックでは概要を説明しました。詳細については、「Microsoft Flow でカスタム コネクタを登録して使用する」をご覧ください。This topic provides an overview; for more information, see Register and use a custom connector.