# Talend Cloud API TesterでAPIをテスト

利用対象...

* Cloud API Services Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Cloud Data Integration
* Cloud Data Management Platform
* Cloud Pipeline Designer Standard Edition
* Data Fabric

データセット上でAPIを有効化したら、Talend Cloud API Testerを使って、リクエストを送信したり、APIをテストしたりできます。

## 始める前に

Talend Cloud API Testerにアクセスできること。詳細は、[Talend Cloud API Testerユーザーガイド](https://help.qlik.com/talend/r/ja-JP/Cloud/api-tester-user-guide)をご覧ください。

## 手順

1. Talend Cloud API Testerで、[Requests] (リクエスト)タブを開いて、左パネルにある[New draft request] (新しい下書きリクエスト)アイコンをクリックします。

   ![\[新しい下書きリクエスト\]アイコンの場所。](https://help.qlik.com/talend/ja-JP/data-inventory-user-guide/Resources/images/restlet-client-new-draft.png)
2. デフォルトのGETメソッドのまま、API URL(たとえばhttps://company-talend-com.eu.talend-dataset.com/apis/customers-api-2PZPTB/customers)を入力してcustomersエンティティセットにあるデータをすべて取得します。

   接続がCloud Engine for Designを使用する場合は、データセットの[API]タブ内にURLが見つかります。Remote Engine Gen2をお使いの場合は、管理者に連絡して、対応するURLを取得します。
3. オプション: パラメータを追加したい場合は、[QUERY PARAMETERS] (クエリーパラメーター)を展開して[Add query parameter] (クエリーパラメーターを追加)をクリックします。

   たとえばcustomer\_cityの値がOlympiaである最初の2件を取得したい場合は、パラメーターを次のように設定します。
   | 名前 | 値 |
   | --- | --- |
   | $filter | customer\_city eq 'Olympia' |
   | $top | 2 |
4. 認証を追加します。
   * 基本認証を使っている場合は、HEADERSの下にある[Add authorization] (認証を追加)をクリックし、いずれかのコンシューマーのユーザー名とパスワードを入力して[Set] (設定)をクリックします。
   * APIキーを使っている場合は、[Add header] (ヘッダーを追加)をクリックし、[name] (名前)フィールドにAuthorizationと入力して、[value] (値)フィールドにTokenとAPIキーを入力します。
5. [Send] (送信)をクリックしてリクエストを送信します。

## タスクの結果

Talend Cloud API Testerはデータセットからデータを返します。この例のパラメーターの場合、レスポンスは次のようになります。

```
{
    "@odata.context": "https://company-talend-com.eu.talend-dataset.com/apis/customers-api-2PZPTB/$metadata#customers",
    "value":[
        {
            "customer_age": "36",
            "id": "g9wjC",
            "customer_name": "Franklin Washington",
            "customer_city": "Olympia",
            "customer_street": "North Erringer Road"
        },
        {
            "customer_age": "68",
            "id": "EVFMD",
            "customer_name": "Ronald Van Buren",
            "customer_city": "Olympia",
            "customer_street": "Bayshore Freeway"
        }
    ]
}
```