- スタート アップ ガイド
- セットアップと構成
- Data Service を使用する
- 参照
- 例とチュートリアル
概要
Data Service Open API allows you to manage UiPath® Data Service resources from an external application of your choice, and does so by enabling you to authorize the external app without sharing any credentials, through the Oauth 2.0 authorization framework.
UiPath ® Automation Suite に外部アプリケーションを登録する 方法について詳しくは、こちらをご覧ください。
API の権限
Data Service OpenAPI を使用するには、外部アプリケーションに API のアクセス許可を付与する必要があります。このような API アクセス許可は「スコープ」とも呼ばれます。Data Service には次の 3 種類のスコープがあります。
- DataService.Schema.Read - このユーザー スコープでは、外部アプリがテナントの Data Service のスキーマを読み取ることができます。スコープはユーザーの権限に依存します。
- DataService.Data.Read - このユーザー スコープでは、外部アプリがテナントの Data Service のデータを読み取ることができます。スコープはユーザーの権限に依存します。
- DataService.Data.Write - このユーザー スコープでは、外部アプリがテナントの Data Service のデータを編集 (削除、更新、新規作成) できます。スコープはユーザーの権限に依存します。
Learn more about the user roles and permissions in Data Service.
OpenAPI 仕様をダウンロードする
外部アプリケーションにユーザー権限を設定したら、次はお使いのテナントの Data Service データの、OpenAPI 仕様をダウンロードします。この操作を行うには、テナントの [Data Service] タブの右上のメニュー > [API アクセス] > [OpenAPI ファイル (JSON) をダウンロード] に移動します。
API 呼び出しを認証する
Data Service のユーザースコープのリソースにアクセスするには、次のいずれかの方法で外部アプリケーションを認可します。
- 認可コード (機密の外部アプリの場合)
- PKCE の認可コード (非機密の外部アプリの場合)
API エンドポイント
OAuth2.0 認可フレームワークではアクセス トークンを生成できます。このアクセス トークンを使用すると、制限時間内 (1 時間) に外部アプリケーションが Data Service エンドポイントに REST API 呼び出しを実行できます。
API の呼び出しを継続するには、アクセス トークンを新しく生成するか、更新トークンを要求する必要があります。
Data Service API エンドポイントの構文は次のようになっています。
-
HTTP メソッド + ベース URL + リソース カテゴリ + Data Service エンティティ + 操作 + パス変数とクエリ パラメーター
Data Service のエンティティの例
各 API 要求/応答の本文について説明するために、ここでは Data Service で作成された「Olympics」エンティティ フィールドを例として使用します。汎用エンドポイント (
Get Entity Recordsなど) を文書化する際は、エンドポイントにはエンティティの正確な名前を含めます (例:Get Olympics Records)。応答と要求の本文には、エンティティの構造を反映してエンティティのすべてのフィールドを含めます。さらに、『 Data Service API ガイド』を使用して各エンドポイントについて詳しく説明 し、その有効活用方法を見つけましょう。