# 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
* Qlik Talend Cloud Enterprise Edition

全セマンティックタイプのリストを取得します。

## 手順

1. パーソナルアクセストークンがまだない場合は1つ生成します。詳細は、[パーソナルアクセストークンを生成](https://help.qlik.com/talend/r/ja-JP/Cloud/management-console-user-guide/cloud-access-token)をご覧ください。
2. ブラウザーでTalend API Testerを開きます。
3. [Repository] (リポジトリー)タブの[Method] (メソッド)ドロップダウンリストで、[Get]を選択します。
4. https://tds.{region}.cloud.talend.com/semanticservice/categoriesというURLを入力します。

   各データセンターで使用するURLのリストは、[Talend Cloudのアプリケーションにアクセス](https://help.qlik.com/talend/ja-JP/installation-guide-windows/Cloud/talend-cloud-application-url)で確認できます。
5. [Add hearder] (ヘッダーの追加)ボタンをクリックし、[name] (名前)フィールドに Authorizationと、そして[value] (値)フィールドにBearerに続けて空白スペースと自分のトークンを入力します。
6. [Send] (送信)をクリックします。

## タスクの結果

リクエストが成功したことを表す200 HTTPコードがAPIによって返されます。このレスポンスにはJSON内の全セマンティックタイプのリストとその属性が含まれています。

多くのAPIの呼び出しでは、セマンティックタイプに割り当てられている一意識別子("id")をパスに含める必要があります。例は、 [APIを使ったサンドボックスステータスでのセマンティックタイプの編集](https://help.qlik.com/talend/ja-JP/data-stewardship-user-guide/Cloud/api-tsd-edit-sandbox)をご覧ください。

たとえば次のレスポンスでは、利用できる2つのセマンティックタイプとその属性のリストが返されます。

```
[
    {
        "id": "5836fbb042b02a698752e679",
        "name": "CONTINENT",
        "label": "Continent",
        "description": "Continent name (multilingual)",
        "type": "DICT",
        "privacyLevel": "NORMAL",
        "creator": "Talend",
        "creatorName": "Talend",
        "createdAt": 1481207929751,
        "completeness": true,
        "publishedAt": 1481207929751,
        "lastPublisher": "Talend",
        "lastPublisherName": "Talend",
        "validationMode": "EXACT_IGNORE_CASE_AND_ACCENT",
        "state": "PUBLISH"
    },
    {
        "id": "583edc44ec06957a34fa642c",
        "name": "WEB_DOMAIN",
        "label": "Web Domain",
        "description": "Website domain",
        "type": "REGEX",
        "privacyLevel": "NORMAL",
        "creator": "Talend",
        "creatorName": "Talend",
        "createdAt": 1481207929751,
        "regEx": {
            "mainCategory": "AlphaNumeric",
            "validator": {
                "patternString": "^([a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,24}$",
                "caseInsensitive": true,
                "re2jCompliant": true,
                "generexCompliant": true
            }
        },
        "completeness": true,
        "publishedAt": 1481207929751,
        "lastPublisher": "Talend",
        "lastPublisherName": "Talend",
        "state": "PUBLISH"
    }
]
```

レスポンスの説明については、[Talend Dictionary Service REST APIドキュメンテーションにアクセス](https://help.qlik.com/talend/ja-JP/data-stewardship-user-guide/Cloud/accessing-talend-dictionary-service-rest-api-documentation)をご覧ください。