REST APIにより、いくつかのメソッドまたはリクエストタイプが使用され、Talend Dictionary Serviceに保管されているデータとのやり取りが簡略化されます。
REST APIドキュメントページはすべて、Swaggerおよび実行リクエストに基づいてアクセスできます。JSONファイルは、REST APIドキュメンテーションのどのページからでもダウンロードできます。
始める前に
Talend Data StewardshipまたはTalend Data Preparationのインストール中にTalend Dictionary Serviceを正しくインストールし、設定している必要があります。
Talend Data StewardshipまたはTalend Data Preparationにログインしていること。
手順
-
ドキュメンテーションにアクセスするアプリケーションに応じて、インストールフォルダー(Talend Data StewardshipとTalend Data Preparationのいずれか)にあるモジュールをすべて開始します。
注: Talend Data PreparationからTalend Dictionary Service REST APIにアクセスするには、まず<Installation_Path>/dataprep/config/application.properties設定ファイルでservice.documenation
パラメーターの値をtrue
に設定する必要があります。
-
Webブラウザーを開いて、次のURLを入力します。
<host>
と<port>
はインストールに応じて異なります:
http://<host>:<port>/docs/api/swagger-ui.html
-
Webブラウザーを開き、https://tds.{region}.cloud.talend.com/docs/api/swagger-ui.htmlというURIを入力します。
-
ページ上部のフィールドで[Semantic Service] (セマンティックサービス)を選択し、Talend Dictionary Serviceドキュメンテーションページを開きます。このページでは操作がさまざまなカテゴリーに分類されています。
例
-
カテゴリー名をクリックすると、そのカテゴリーの下に操作リストが表示されます。
-
の順にクリックし、認証情報を使ってログインします。
[Response Headers] (レスポンスヘッダー)エリアにベアラーの認証情報が表示されます。
-
各操作の実行テストを開始します。
実行した操作の結果を得るには、レスポンスからCurlコマンドを使用します。
ログイン時に取得したベアラートークンを認証ヘッダーの一部として含めます。
例
curl -X GET --header 'Authorization: Bearer <token>' --header 'Accept: application/json' 'http://<host>:<port>/categories?caseSensitive=false&isExact=false'