注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
REST
Foundry は REST（representational state transfer）API を公開する外部システムと統合できます。同期、エクスポート、あるいは REST API を対話的に呼び出すかどうかにより、異なるアプローチを使用する必要があります。このページでは、REST API との安全かつ効率的な統合のためのいくつかの接続オプションを見つけることができます。
REST API ソース
REST API ソースは、Foundry アプリケーションからのアクション経由で外部システムに対する対話的な HTTP リクエストを必要とするワークフローで使用できます。例えば、Webhook を使用してボタンをクリックしたときに REST エンドポイントを呼び出す Workshop アプリケーションを作成し、そのアプリケーションを既存のワークフローとソースシステムに接続することができます。
HTTP エンドポイントへの Webhook は、Data Connection の REST API ソースタイプを使用する必要があります。ベース URL、認証、およびオプションのポートを設定する必要があります。
| オプション | 必須 | 説明 |
|---|---|---|
| ドメイン | はい | 少なくとも1つのドメインを指定する必要があります。 |
| 認証 | はい | 各ドメインについて、認証を指定する必要があります。オプションには None、Basic、Bearer Token、API Key が含まれます。 |
| ポート | いいえ | ポートはオプションで指定できます。デフォルトでは、すべての REST Webhook は HTTPS を使用してポート 443 で使用します。443 以外のポートはエージェントランタイムを使用している場合にのみサポートされます。 |
| リクエストオプション | いいえ | API Key 認証を選択する場合、Webhook リクエストで API Key をクエリパラメータまたはヘッダーとして渡すかどうかを選択できます。 |
以下の例の設定では、ベアラートークン認証を使用して https://my-domain.com に接続する方法を示しています。
REST API ソースタイプは、同期やエクスポートなどの他の機能をサポートしていません。レガシーの magritte-rest-v2 ソースタイプは Webhook ワークフローにはもはや推奨されていません。REST API への同期とエクスポートは、外部トランスフォームを使用すべきです。
Foundry での Webhook について詳しくはこちら。
コードリポジトリの外部トランスフォーム
ネットワークの出口と資格情報を設定し、API にアクセスするロジックを記述するために Python トランスフォームリポジトリを使用します。例えば、Foundry データセットのメタデータを処理するための API をクエリするためや、API サービスと対話してデータセットに画像を出力するために、外部トランスフォームを使用することができます。REST API を呼び出す必要がある同期やエクスポートの設定には、外部トランスフォームが推奨されています。
外部トランスフォームは現在、オンプレミスシステムと通信するためのエージェントランタイムをサポートしていません。レガシーの magritte-rest-v2 ソースタイプはオンプレミスの REST API コールに使用できますが、直接接続にはもはや推奨されていません。ファイアウォールの後ろにある REST API を呼び出す必要がある場合は、詳細については Palantir の代表者にお問い合わせください。
外部トランスフォームを使用した API の呼び出しについて詳しくはこちら。
Foundry REST API
Foundry プラットフォームの上にアプリケーションを構築したい場合は、Foundry REST API を使用します。Foundry API は OAuth 2.0 プロトコルを使用して認証を行い、主に JSON のリクエストとレスポンスを使用し、オントロジーとモデリングリソースのサポートを提供します。