サードパーティ サービス [非推奨]
項目一覧
重要
サードパーティ サービスとプッシュ通知の廃止
Atlas App Services のサードパーティ サービスとプッシュ通知は非推奨となり、代わりに関数内の外部依存関係を使用する HTTP エンドポイントを作成できるようになりました。
Webhook はHTTPS endpointsに名前変更され、動作は変更されません。 既存の Webhook を移行する必要があります。
既存のサービスは、 30、2025 まで引き続き機能します。
サードパーティ サービスとプッシュ通知は非推奨になったため、App Services UI からデフォルトで削除されました。 既存のサードパーティ サービスまたはプッシュ通知を管理する必要がある場合は、次の操作を実行して構成を UI に追加できます。
左側のナビゲーションの [ App Settings Manageセクションの下にある [] をクリックします。
Temporarily Re-Enable 3rd Party Servicesの横にあるトグル スイッチを有効にし、変更を保存します。
はじめに
最近のアプリケーションは、メッセージング、分析、データ管理などの複雑なユースケースを処理するために複数の外部サービスを使用することが多い。 サービス インターフェースを作成および構成することで、Atlas App Services を介してこれらのサービスに接続できます。
サービス インターフェースは、特定の外部サービスの接続の詳細を指定し、カスタムサービス ルールを使用してそのサービスの機能の範囲を定義できるようにします。 サービスのインターフェースを構成したら、そのインターフェースに接続し、サービスの アクション をメソッドとして公開する サービス クライアント をインスタンス化できます。また、外部サービスが HTTP 経由でアプリと直接通信できるようにする受信 Webhookを作成することもできます。
注意
組み込みサービスクライアント
Atlas App Services には、 TwilioやAmazon Web Servicesなどの特定の外部サービスのクライアントが含まれます。 また、 HTTP Serviceを使用して、 REST APIを提供する任意の外部サービスのカスタム インターフェイスを作成することもできます。
コンセプト
サービス クライアント [非推奨]
サービス クライアントは、サービス インターフェースに接続し、そのサービスに関連するアクションを呼び出せるようにするオブジェクトです。 関数（関数コンテキストを使用）内とクライアント アプリケーション コード内でサービス クライアントをインスタンス化できます。
サービス クライアントのインスタンス化とサービス クライアントの使用の詳細については、「サービス アクションの呼び出し 」を参照してください。
サービス アクション [非推奨]
サービスアクションは、Twilio でテキストメッセージを送信 したり、Amazon Web Services S3 バケット にオブジェクト を配置したりするなど、特定のサービスの特定のユースケースを処理するメソッドです。アクションは、各サービスに固有のセマンティック メソッドの背後にあるリクエスト認証や HTTP メソッドなどの詳細な実装をカプセル化します。
サービス アクションを呼び出すと、App Services はアクションに適用される各サービス ルールを評価し、いずれかのルールが trueと評価されない限り実行を防ぎます。
重要
App Services は、デフォルトですべてのサービス アクションをブロックします。 特定のアクションを呼び出す前に、そのアクションを有効にするサービス ルールを構成する必要があります。
サービス ルール [非推奨]
サービス ルールは、ユーザーがサービス内で 1 つ以上の アクション を実行できるかどうかを決定するために Atlas App Services が評価する 式 です。
たとえば、特定の電話番号からのテキスト メッセージのみをユーザーに送信するTwilioのルールや、承認されたバケットのリストに含まれていない S3 バケットへのオブジェクトの配置を禁止するAmazon Web Servicesのルールを作成できます。
受信 Webhook [非推奨]
受信 Webhook は、 Githubで新しいプルリクエストを開いたり、 Twilioの電話番号にテキスト メッセージを送信したりする場合など、外部サービスから発生するイベントのカスタム ハンドラーです。 サービス Webhook を構成して、受信 Webhook を使い始める。
受信する Webhook は、Webhook URL と Webhook 関数の 2 つのプライマリコンポーネントで構成されています。
コンポーネント | 説明 |
|---|---|
Webhook URL | 受信する Webhook を一意に識別する URL。 外部サービスは、Webhook の構成に一致する HTTP リクエストを Webhook URL に送信することで、Webhook と対話できます。 Webhook を使用するには、外部サービスの HTTP リクエスト ハンドラーへの Webhook URL を指定します。これは、送信 Webhook、コールバック URL などと呼ばれることもあります。 注意受信する Webhook にシークレット クエリ パラメータが必要な場合は、外部サービスに提供する前に、Webhook URL にクエリ パラメータを追加してください。 |
Webhook Function | Webhook 関数は、外部サービスからのデータを引数として受信 HTTP リクエストを受け入れ、オプションで HTTP レスポンスを返すAtlas Functionです。 |
ガイド
Guide | 説明 |
|---|---|
新しい外部サービス インターフェイスを作成する方法を学習します。 | |
受信 Webhook を構成して実行し、外部サービスのイベントを処理する方法を学習します。 | |
関数またはクライアント アプリケーションで使用するためにサービス アクションを安全に公開する方法を学習します。 | |
関数またはクライアント アプリケーションからサービス アクションを呼び出す方法を学習します。 |
組み込みサービス
件名 | 説明 |
|---|---|
サービス構成パラメータ、Twilio に Webhook を追加するための方向、および Twilio のサービス アクションに関する追加情報が含まれます。 | |
HTTP Serviceアクションと Webhook に関する追加情報が含まれます。 | |
サービス構成パラメータ、特定のAmazon Web Servicesサービスアクションに関する追加情報、およびAmazon Web Servicesサービスに接続するための一般的な方向が含まれます。 | |
サービス構成パラメータ、 Githubに Webhook を追加するための方向、 Githubからの受信リクエストを検証するためのガイダンスが含まれます。 |
リファレンス ドキュメント
件名 | 説明 |
|---|---|
受信リクエストを確認し、リクエスト ペイロードを解析し、サービス Webhook 関数で応答を送信する方法について説明します。 |